Techerest

วิธีใช้ .gitignore ใน GitHub Desktop บน Windows 11 Pro สำหรับมือใหม่ เพื่อไม่ให้ไฟล์ที่ไม่ต้องการถูก Commit

วิธีใช้ .gitignore ใน GitHub Desktop บน Windows 11 Pro เพื่อไม่ให้ไฟล์ที่ไม่ต้องการถูก Commit

เปิด GitHub Desktop แล้วพบไฟล์ชั่วคราว Log หรือโฟลเดอร์ที่โปรแกรมสร้างขึ้นเต็มหน้า Changes จนหาไฟล์งานจริงไม่เจอ? คุณสามารถใช้ .gitignore เพื่อระบุว่าไฟล์แบบใดไม่ควรถูกนำเข้าประวัติ Git

คู่มือ Tech Help จาก techerest.com บทความนี้จะพาสร้าง .gitignore บน Windows 11 Pro พร้อมตัวอย่างกฎที่นำไปปรับใช้ได้ และอธิบายจุดสำคัญว่า ไฟล์ที่ Git ติดตามอยู่แล้วจะไม่หยุดถูกติดตามเพียงเพราะเพิ่มชื่อใน .gitignore

1. .gitignore คืออะไร?

.gitignore คือไฟล์ข้อความที่บันทึกกฎสำหรับละเว้นไฟล์และโฟลเดอร์ซึ่งยังไม่ได้ถูก Git ติดตาม เช่น Log ไฟล์ชั่วคราว หรือผลลัพธ์ที่สร้างใหม่ได้

เมื่อกฎตรงกับไฟล์ที่ยังไม่ถูกติดตาม ไฟล์นั้นจะไม่ปรากฏเป็นงานใหม่ใน Changes ตามปกติ แต่ยังอยู่ในคอมพิวเตอร์และใช้งานได้

.gitignore ไม่ได้ลบไฟล์ ไม่ได้เข้ารหัส และไม่ได้ล้างข้อมูลจาก Commit เก่า จึงต้องตรวจทั้งสถานะไฟล์และประวัติก่อนนำไปใช้กับข้อมูลสำคัญ

อ้างอิง: GitHub Docs: Ignoring files

2. ควร Ignore ไฟล์อะไรบ้าง?

ประเภทไฟล์ แนวทางพิจารณา
Log และไฟล์ชั่วคราว มักไม่จำเป็นต้องเก็บในประวัติโค้ด
ไฟล์ตั้งค่าส่วนตัวของเครื่อง แยกจากการตั้งค่าที่ทีมต้องใช้ร่วมกัน
Dependency ที่ติดตั้งใหม่ได้ ใช้กฎตามภาษาและเครื่องมือของโปรเจกต์
ผลลัพธ์จากการ Build ตรวจวิธีเผยแพร่ก่อน เพราะบางโปรเจกต์ต้องเก็บผลลัพธ์บางส่วน
ไฟล์ที่มีรหัสผ่านหรือ API key ไม่ควร Commit ข้อมูลลับ และต้องตรวจการจัดเก็บ Secrets เพิ่มเติม

อย่า Ignore ทุกไฟล์ที่ดูไม่คุ้นชื่อ ไฟล์อย่าง Lock file หรือการตั้งค่าบางรายการอาจจำเป็นต่อการติดตั้งและทำงานร่วมกัน ควรตรวจแนวทางของเครื่องมือที่ใช้ก่อน

3. เตรียม Repository และแสดงนามสกุลไฟล์บน Windows

  1. เปิด GitHub Desktop และตรวจ Current repository ให้ถูกโปรเจกต์
  2. ตรวจ Current branch ก่อนแก้กฎ
  3. เลือก Repository → Show in Explorer
  4. ใน File Explorer เปิด View → Show → File name extensions
  5. ตรวจว่าในโฟลเดอร์โปรเจกต์มี .gitignore อยู่แล้วหรือไม่

หากมีไฟล์เดิม ให้เปิดแก้และเพิ่มกฎตามความจำเป็น อย่าสร้างไฟล์ใหม่ทับกฎของโปรเจกต์โดยไม่อ่านก่อน

บทเรียนนี้จะวาง .gitignore ที่ โฟลเดอร์หลักของ Repository เช่น ตำแหน่งเดียวกับ README เพื่อให้เริ่มตรวจขอบเขตได้ง่าย

4. สร้าง .gitignore ด้วย Notepad

  1. เปิด Notepad และพิมพ์กฎที่ต้องการ
  2. เลือก File → Save as
  3. เลือกโฟลเดอร์หลักของ Repository
  4. ตั้งชื่อไฟล์เป็น .gitignore
  5. เลือก Save as type เป็น All files และใช้ UTF-8
  6. บันทึก แล้วตรวจชื่อจริงใน File Explorer อีกครั้ง

ชื่อที่ถูกต้องคือ .gitignore ไม่ใช่ .gitignore.txt การเปิดแสดงนามสกุลไฟล์ช่วยให้เห็นข้อผิดพลาดนี้ได้ทันที

ตัวอย่างกฎสำหรับเริ่มฝึก

# Log files
*.log

# Temporary files
*.tmp

# Personal notes at repository root
/private-notes.txt

# Temporary folder at repository root
/temp/

ตัวอย่างนี้เหมาะสำหรับทดลอง ไม่ใช่รายการมาตรฐานที่ต้องใส่ทุกโปรเจกต์ หากเริ่ม Repository ใหม่ผ่าน GitHub Desktop คุณยังเลือก Git ignore template ตามภาษาหรือเครื่องมือได้ในหน้าสร้าง Repository

อ้างอิง: GitHub Docs: ตัวเลือก Git ignore เมื่อสร้าง Repository

5. อ่านกฎ .gitignore อย่างไร?

กฎ ผลที่ต้องการ
# Log files บรรทัดคำอธิบาย ไม่ใช่กฎละเว้น
*.log ละเว้นชื่อที่ลงท้ายด้วย .log
/private-notes.txt ละเว้นไฟล์ชื่อนี้ที่โฟลเดอร์หลัก เมื่อกฎอยู่ใน .gitignore หลัก
/temp/ ละเว้นโฟลเดอร์ temp ที่โฟลเดอร์หลักและเนื้อหาภายใน
!important.log ยกเว้นให้ชื่อนี้ไม่ถูกละเว้นจากกฎก่อนหน้า หากไม่มีเงื่อนไขอื่นขัดขวาง

ใช้เครื่องหมาย / สำหรับเส้นทางในกฎ แม้ใช้งานบน Windows และควรเริ่มจากกฎที่เจาะจงก่อนใช้รูปแบบกว้าง

ตัวอย่างละเว้น Log แต่เก็บไฟล์ตัวอย่างหนึ่งไฟล์

*.log
!important.log

ลำดับกฎมีผล และการยกเว้นไฟล์ภายในโฟลเดอร์ที่ถูก Ignore ทั้งโฟลเดอร์มีเงื่อนไขเพิ่มเติม สำหรับมือใหม่ หากยังไม่แน่ใจให้ปรับกฎให้เจาะจงแทนการใช้ข้อยกเว้นซ้อนหลายชั้น

6. ทดสอบว่ากฎทำงานก่อน Commit

ใช้ไฟล์ทดลองที่ไม่มีข้อมูลสำคัญ และยังไม่เคยถูก Commit เพื่อให้เห็นผลชัดเจน

  1. สร้างไฟล์ debug.log ใน Repository และใส่ข้อความทดสอบ
  2. สร้างไฟล์ practice.md สำหรับงานที่ต้องการเก็บ
  3. บันทึก .gitignore ที่มีกฎ *.log
  4. กลับ GitHub Desktop แล้วตรวจ Changes
  5. ยืนยันว่า debug.log ไม่แสดงเป็นไฟล์ใหม่ แต่ practice.md และ .gitignore ยังแสดง
  6. เปิด File Explorer เพื่อตรวจว่า debug.log ยังอยู่จริง

การทดสอบนี้ช่วยยืนยันสองเรื่องพร้อมกัน คือไฟล์ถูกละเว้นจาก Git ตามปกติ และไม่ได้ถูกลบออกจากเครื่อง

7. ต้อง Commit ไฟล์ .gitignore ด้วยไหม?

ควร Commit หากเป็นกฎที่ทีมต้องใช้ร่วมกัน เช่น โฟลเดอร์ Dependency หรือผลลัพธ์ Build ที่ไม่ต้องการติดตาม เมื่อผู้อื่นรับไฟล์นี้ไปก็จะได้กฎของโปรเจกต์ด้วย

  1. ตรวจ Changes ว่า .gitignore มีกฎตรงตามที่ตั้งใจ
  2. เลือก .gitignore และไฟล์งานที่ต้องการ Commit
  3. ใส่ Summary เช่น chore: ignore temporary files and logs
  4. Commit แล้ว Push หรือเสนอผ่าน Pull Request ตามกระบวนการของทีม

หากเป็นกฎเฉพาะเครื่องที่ไม่ควรแชร์ Git ยังรองรับ .git/info/exclude และกฎแบบ Global แต่ควรแยกให้ชัดจาก .gitignore ของโปรเจกต์

อ้างอิง: GitHub Docs: กฎร่วมกันและการละเว้นเฉพาะเครื่อง

8. เพิ่ม .gitignore แล้ว ทำไมไฟล์ยังขึ้นใน Changes?

สาเหตุสำคัญคือ ไฟล์นั้นถูก Git ติดตามอยู่แล้ว เช่น เคย Commit debug.log มาก่อน การเพิ่มกฎ *.log จะไม่หยุดติดตามไฟล์เดิมให้เอง

หากต้องการเก็บไฟล์ไว้ในเครื่องแต่เอาออกจากรายการที่ติดตาม ต้องทำขั้นตอน Untrack เพิ่มเติม ตัวอย่างนี้เป็นส่วนที่ใช้คำสั่ง Git แทนการคลิกใน Desktop

ตัวอย่างหยุดติดตาม debug.log โดยเก็บไฟล์ในเครื่อง

  1. ตรวจว่าไฟล์ในเครื่องถูกบันทึกแล้ว และเก็บสำเนาเพิ่มเติมหากจำเป็น
  2. เพิ่ม /debug.log ลง .gitignore และบันทึก
  3. เปิด Terminal ที่ใช้งาน Git ได้ในโฟลเดอร์หลักของ Repository
  4. รันคำสั่งเฉพาะไฟล์ดังนี้
git rm --cached -- "debug.log"

หาก Terminal แจ้งว่าไม่รู้จักคำสั่ง git ต้องติดตั้งหรือกำหนด Git สำหรับ Terminal ให้พร้อมก่อน การติดตั้ง GitHub Desktop ไม่ได้ยืนยันว่าทุก Terminal จะเรียกคำสั่ง git ได้ทันที

หลังคำสั่งสำเร็จ ให้กลับ GitHub Desktop ตรวจว่ามีการเอา debug.log ออกจากเวอร์ชันที่ติดตาม พร้อมการแก้ .gitignore จากนั้น Commit ทั้งสองรายการ

สถานะลบใน Git ครั้งนี้หมายถึงเอาไฟล์ออกจาก Snapshot ของ Repository คำสั่ง --cached มีเป้าหมายเก็บไฟล์ทำงานในเครื่องไว้ แต่ควรเปิดตรวจไฟล์จริงก่อนยืนยัน Commit

เมื่อแชร์ Commit นี้ ผู้ร่วมงานอาจได้รับผลจากการนำไฟล์ออกจาก Repository จึงควรแจ้งทีม โดยเฉพาะไฟล์ตั้งค่าที่แต่ละคนใช้งานอยู่ อย่าใช้คำสั่งล้างทั้ง Repository หรือเพิ่มตัวเลือกบังคับเพียงเพื่อข้ามข้อผิดพลาด

อ้างอิง: GitHub Docs: การหยุดติดตามไฟล์ที่เคย Commit

9. ตัวอย่าง .gitignore สำหรับไฟล์ตั้งค่าภายในเครื่อง

หากโปรเจกต์ใช้ไฟล์ .env เก็บค่าภายในเครื่อง คุณอาจกำหนดกฎดังนี้ โดยต้องตรวจว่าเหมาะกับโปรเจกต์จริงก่อน:

# Local environment files
.env
.env.*

# Keep the template without real secrets
!.env.example

ไฟล์ .env.example ควรมีเฉพาะชื่อตัวแปรและค่าตัวอย่างที่ไม่ใช่รหัสจริง เพื่อให้คนอื่นทราบว่าต้องตั้งค่าอะไร

หาก Password, Token หรือ API key ถูก Commit หรือ Push ไปแล้ว .gitignore ไม่ได้แก้การรั่วไหลย้อนหลัง ให้เพิกถอนหรือเปลี่ยนรหัสที่เปิดเผย และจัดการประวัติตามแนวทางของโปรเจกต์

อ้างอิง: GitHub Docs: Removing sensitive data from a repository

10. ปัญหาที่มือใหม่มักพบ

สร้าง .gitignore แล้ว แต่ไม่เกิดผลเลย

ตรวจชื่อจริงว่าไม่ได้ลงท้าย .txt ตรวจว่า Save แล้ว อยู่ใน Repository ที่กำลังใช้งาน และกฎตรงกับเส้นทางไฟล์ จากนั้นตรวจว่าไฟล์เป้าหมายเคยถูกติดตามหรือไม่

เอาเครื่องหมายหน้าไฟล์ออกใน Changes แทนได้ไหม?

ทำได้หากเพียงไม่ต้องการรวมไฟล์นั้นใน Commit ครั้งนี้ แต่ไฟล์อาจยังแสดงในครั้งถัดไป การไม่เลือกไฟล์ไม่ได้สร้างกฎ Ignore ถาวร

Ignore แล้วไฟล์หายจาก GitHub หรือไม่?

ไฟล์ที่เคย Commit จะไม่หายจาก GitHub เพียงเพราะเพิ่มกฎ ต้องจัดการการติดตามและส่ง Commit ที่เกี่ยวข้อง ส่วนประวัติเก่ายังอาจมีไฟล์อยู่

ควร Ignore โฟลเดอร์ .vscode ทั้งหมดไหม?

ขึ้นอยู่กับทีม เพราะบางไฟล์เป็นการตั้งค่าร่วมที่ช่วยให้ทำงานตรงกัน ขณะที่บางไฟล์เป็นข้อมูลส่วนตัว ควรเลือกตามจุดประสงค์แทนการ Ignore ทั้งโฟลเดอร์โดยอัตโนมัติ

ลบกฎแล้ว ไฟล์จะถูก Commit ทันทีไหม?

ไม่ทันที ไฟล์ที่ไม่ได้ถูกละเว้นด้วยกฎอื่นอาจกลับมาแสดงใน Changes แต่ยังต้องเลือกและ Commit ก่อน จึงจะถูกบันทึกลงประวัติ

เช็กลิสต์ก่อน Commit หลังเพิ่ม .gitignore

  • ชื่อไฟล์เป็น .gitignore จริงและอยู่ในตำแหน่งที่ตั้งใจ
  • อ่านกฎเดิมก่อนเพิ่มหรือแก้ไข
  • ทดสอบกับไฟล์ที่ยังไม่ถูกติดตามแล้ว
  • ไฟล์งานสำคัญไม่ได้ถูก Ignore โดยไม่ตั้งใจ
  • ตรวจแยกกรณีไฟล์ที่เคย Commit
  • ไม่มีรหัสลับหรือข้อมูลส่วนตัวติดไปกับ Commit
  • Commit กฎที่ต้องแชร์ให้ทีมและตรวจผลหลัง Push

เริ่มจากกฎที่เจาะจงและทดสอบใน Changes ก่อนทุกครั้ง เมื่อเข้าใจว่าไฟล์ใดยังไม่ถูกติดตามและไฟล์ใดอยู่ในประวัติแล้ว คุณจะใช้ .gitignore ช่วยลดรายการรบกวนและเลือก Commit งานได้มั่นใจขึ้น

Share this
Facebook Share X
TECHEREST COMMUNITY

Share your thoughts here

Join the conversation and share your perspective on this article.

Comments will load when you reach this section.