วิธี Squash Commits ใน GitHub Desktop บน Windows 11 Pro รวมหลาย Commit เป็นหนึ่งก่อน Push
ระหว่างพัฒนาโปรแกรม คุณอาจ Commit หลายครั้ง เช่น เพิ่มฟังก์ชัน แก้คำผิด และปรับรายละเอียดเล็กน้อย เมื่อทำงานเสร็จจึงอยากรวมรายการเหล่านี้ให้เป็นงานชุดเดียวก่อนส่งขึ้น GitHub
Squash Commits คือการรวมหลาย Commit ให้เป็น Commit เดียว ช่วยให้ประวัติอ่านง่าย โดยเฉพาะเมื่อรายการที่รวมเป็นส่วนหนึ่งของงานเดียวกัน
คู่มือ Tech Help จาก techerest.com บทความนี้จะพาทำผ่าน GitHub Desktop บน Windows 11 Pro โดยใช้ตัวอย่าง Commit ที่เรียงติดกันและยังไม่ได้ Push พร้อมวิธีตรวจว่าเนื้อหางานยังครบหลังรวม
1. Squash เปลี่ยนอะไรในประวัติ?
สมมติว่าคุณมี Commit เล็ก ๆ สามรายการสำหรับเพิ่มคู่มือการติดตั้ง หลัง Squash จะได้ Commit ใหม่หนึ่งรายการที่ครอบคลุมการเปลี่ยนแปลงของงานชุดนั้น
ก่อน Squash
A → B → C → D
A = จุดเริ่มต้น
B = เพิ่มคู่มือติดตั้ง
C = แก้คำผิดในคู่มือ
D = เพิ่มขั้นตอนตรวจผล
หลัง Squash B, C และ D
A → S
S = คู่มือติดตั้งที่แก้ไขครบแล้ว
Squash ไม่ใช่การเลือกเก็บเฉพาะไฟล์จาก Commit ใด Commit หนึ่ง ในตัวอย่างนี้ เป้าหมายคือรักษาผลลัพธ์สุดท้ายของ B ถึง D แล้วจัดประวัติให้เหลือรายการเดียว
อ้างอิง: GitHub Docs: Squashing commits in GitHub Desktop
2. เมื่อไรควรรวม Commit และเมื่อไรควรแยกไว้?
| ตัวอย่างงาน | แนวทางที่เหมาะ |
|---|---|
| เพิ่มคู่มือ แก้คำผิด และเติมขั้นตอนในคู่มือเดียวกัน | รวมเป็น Commit เดียวได้ หากเป็นงานชุดเดียวกัน |
| เพิ่มฟังก์ชัน แล้วแก้รายละเอียดก่อนส่งตรวจครั้งแรก | พิจารณารวมให้เห็นผลลัพธ์ที่พร้อมตรวจ |
| แก้บั๊กเข้าสู่ระบบและเปลี่ยนสีหน้าเว็บไซต์ | ควรแยก เพราะมีจุดประสงค์ต่างกัน |
| งานถูก Push และมีผู้อื่นทำต่อแล้ว | ประสานทีมก่อนเปลี่ยนประวัติ |
ไม่จำเป็นต้องทำให้ทุก Branch เหลือ Commit เดียว ประวัติที่ดีควรช่วยให้ผู้อ่านเข้าใจงาน และย้อนการเปลี่ยนแปลงเป็นส่วน ๆ ได้เมื่อจำเป็น
3. เตรียมก่อนเริ่ม Squash
- ตรวจ Current repository และ Current branch ให้ถูกต้อง
- บันทึกไฟล์ที่เปิดแก้ในโปรแกรมเขียนโค้ด
- ตรวจแท็บ Changes และจัดการงานที่ยังไม่ได้ Commit ก่อน
- เปิด History แล้วอ่านรายการที่จะรวม
- ยืนยันว่า Commit เป้าหมายยังไม่ได้ Push
สำหรับบทเรียนนี้ แนะนำให้เลือก Commit ธรรมดาที่เรียงติดกันตรงปลาย Branch และเป็นงานเดียวกันทั้งหมด เพื่อให้ตรวจขอบเขตได้ง่าย
หากต้องการเก็บจุดอ้างอิงของประวัติเดิม สามารถสร้าง Branch สำรองจากตำแหน่งปัจจุบัน เช่น backup-before-squash แล้วสลับกลับ Branch งานก่อนดำเนินการ ทั้งนี้ Branch สำรองไม่ได้เก็บการแก้ไขที่ยังไม่ Commit ให้โดยอัตโนมัติ
4. วิธี Squash Commits ใน GitHub Desktop
ตัวอย่างนี้ต้องการรวม B, C และ D โดยใช้ B เป็นรายการที่นำ Commit อื่นมารวมด้วย
- คลิก Current branch แล้วเลือก Branch งาน
- เปิดแท็บ History
- กด Ctrl ค้างแล้วเลือก C และ D หรือใช้ Shift เลือกช่วงที่ต้องการ
- ลากรายการที่เลือกไปวาง ทับ Commit B
- ตรวจหน้าต่าง Squash และรายการที่กำลังจะรวม
- ปรับ Summary และ Description ให้สื่อถึงงานทั้งหมด
- คลิก Squash Commits
วางทับรายการ Commit เป้าหมาย และตรวจว่าหน้าจอกำลังทำ Squash ไม่ใช่ลากไปแทรกระหว่างรายการเพื่อเปลี่ยนลำดับ Commit
หากมีคำเตือนว่าต้อง Force push ให้หยุดตรวจสถานะก่อน เพราะตัวอย่างนี้ตั้งใจรวมเฉพาะงานที่ยังไม่ Push
อ้างอิงขั้นตอน: GitHub Docs: วิธีเลือกและลาก Commit เพื่อ Squash
5. เขียนข้อความ Commit ใหม่อย่างไรให้อ่านรู้เรื่อง?
ไม่ควรนำข้อความทดลองทั้งหมดมาต่อกันโดยไม่ปรับ ลองอธิบายผลลัพธ์ของงานให้คนที่ไม่เห็นขั้นตอนระหว่างทางเข้าใจได้
ตัวอย่างข้อความเดิม
add setup guide
fix typo
add missing verification step
ตัวอย่างข้อความหลังรวม
Summary:
docs: add Windows 11 Pro setup guide
Description:
- Add installation instructions
- Correct wording in the guide
- Include steps to verify the installation
หากมีผลทดสอบหรือข้อจำกัดที่จำเป็นต่อผู้ตรวจ สามารถบันทึกเพิ่มได้ แต่ให้ระบุเฉพาะสิ่งที่ทำจริง
6. ตรวจผลหลัง Squash ก่อน Push
ตรวจ History
ในตัวอย่าง B, C และ D ควรถูกแทนด้วย Commit รวมหนึ่งรายการบน Branch งาน ส่วน A ยังคงเป็นจุดก่อนหน้างานชุดนี้ รหัส Commit รวมจะเป็นรหัสใหม่ จึงไม่ควรคาดว่าจะเหมือน B เดิม
ตรวจความเปลี่ยนแปลงของ Commit รวม
คลิก Commit ใหม่แล้วอ่านรายการไฟล์ เปรียบเทียบกับขอบเขตงานที่ตั้งใจ เช่น คู่มือต้องยังมีเนื้อหาเริ่มต้น คำที่แก้แล้ว และขั้นตอนตรวจผลครบ
เปิดไฟล์และทดสอบ
เปิดไฟล์จริงจาก Repository เพื่อตรวจผลลัพธ์ หากเป็นเอกสารให้ตรวจเนื้อหาและลิงก์ หากเป็นโปรแกรมให้ทดสอบส่วนที่เกี่ยวข้อง การรวมประวัติสำเร็จไม่ได้ยืนยันว่าโค้ดถูกต้องทุกด้าน
ตรวจ Changes
หากเริ่มด้วย Changes ว่างและไม่ได้แก้ไฟล์เพิ่มระหว่างทาง หลังดำเนินการควรไม่มีงานค้างที่ไม่ทราบที่มา หากพบรายการ ให้เปิดอ่านก่อนทำขั้นตอนต่อไป
7. ส่ง Commit ที่รวมแล้วขึ้น GitHub
- ตรวจ Current branch อีกครั้ง
- คลิก Push origin หากเผยแพร่ Branch ไว้แล้ว หรือ Publish branch หากยังไม่เคยเผยแพร่
- รอการส่งข้อมูลเสร็จ
- เปิด Branch เดียวกันบน GitHub
- ตรวจข้อความ Commit และเนื้อหาไฟล์
สำหรับตัวอย่างที่รวมเฉพาะ Commit ใหม่ซึ่งยังไม่ Push โดยไม่เปลี่ยนประวัติที่แชร์แล้ว ควรส่งงานได้ตามปกติ หากพบคำขอ Force push หรือข้อผิดพลาดอื่น ให้ตรวจสถานะจริงก่อนกดยืนยัน
8. แบบฝึกหัด: รวมงานเอกสารสาม Commit
ทดลองใน Repository ส่วนตัว โดยมี README เริ่มต้นอยู่แล้วและ Changes ว่าง จากนั้นสร้าง Branch ชื่อ practice-squash
- เพิ่มหัวข้อ
## Installationพร้อมคำแนะนำหนึ่งบรรทัดใน README แล้ว Commit เป็นdocs: add installation section - เพิ่มรายละเอียดการติดตั้ง แล้ว Commit เป็น
docs: expand installation steps - เพิ่มหัวข้อ
## Verificationและวิธีตรวจผล แล้ว Commit เป็นdocs: add verification steps - ยังไม่ต้อง Push
- ใน History เลือกสอง Commit หลัง แล้วลากทับ Commit แรกของงานเอกสารชุดนี้
- ตั้ง Summary ใหม่เป็น
docs: add installation and verification guide - ยืนยัน Squash แล้วอ่าน README ว่าเนื้อหายังครบ
- ตรวจ History ก่อน Publish branch หรือ Push
อย่าลากไปรวมกับ Commit ตั้งต้นของ Repository โดยไม่ตั้งใจ เป้าหมายของแบบฝึกหัดคือรวมเฉพาะสาม Commit ที่เพิ่งสร้าง ไม่ใช่รวมประวัติทั้งหมด
9. ปัญหาที่อาจพบระหว่าง Squash
แอปแจ้งว่ามี Uncommitted changes
ให้กลับไปอ่านงานใน Changes ก่อน แอปอาจเสนอให้ Stash แล้วทำต่อ หรือปิดหน้าต่างเพื่อ Commit งานก่อน สำหรับมือใหม่ การแยกจัดเก็บงานให้เรียบร้อยก่อนเริ่มจะตรวจผลได้ง่ายกว่า
แอปแจ้งว่ามี Merge Commit อยู่ในรายการ
GitHub Desktop อาจไม่สามารถ Squash ชุดที่มี Merge Commit ได้ ให้ตรวจรายการที่เลือกและใช้ชุด Commit ธรรมดาตามตัวอย่าง หากประวัติซับซ้อน ควรตรวจร่วมกับทีมก่อนเปลี่ยนโครงสร้าง
แอปแจ้งว่าต้อง Force push
แสดงว่าการเปลี่ยนประวัติครั้งนี้กระทบข้อมูลที่แชร์กับ Remote แล้ว การ Force push อาจมีผลกับผู้ร่วมงาน จึงไม่ควรทำต่อเพียงเพื่อให้หน้าต่างหายไป
ข้อผิดพลาดและคำเตือนข้างต้นอ้างอิงจาก GitHub Docs: Error messages when squashing commits
ลากแล้วกลายเป็นการจัดลำดับ Commit
อย่ายืนยันหน้าต่างที่ไม่ตรงกับเป้าหมาย ให้ยกเลิกแล้วตรวจตำแหน่งวางอีกครั้ง การ Squash ใช้การวางทับ Commit ที่จะรวมด้วย ส่วนการแทรกระหว่างรายการเกี่ยวข้องกับการเปลี่ยนลำดับ
10. Squash ต่างจาก Amend และ Reset อย่างไร?
| เครื่องมือ | เป้าหมายหลัก |
|---|---|
| Squash | รวมหลาย Commit เป็นหนึ่ง พร้อมข้อความใหม่ |
| Amend | ปรับ Commit ล่าสุด เช่น แก้ข้อความหรือเพิ่มไฟล์ที่ลืม |
| Reset to commit | นำงานหลังจุดที่เลือกกลับมาเป็น Changes เพื่อแก้หรือแบ่ง Commit ใหม่ |
| Revert | เพิ่ม Commit เพื่อย้อนผลของงาน โดยเก็บประวัติเดิม |
หากงานครบและต้องการรวมประวัติ Squash อาจตรงเป้าหมาย แต่หากต้องแก้ไฟล์และจัดกลุ่มงานใหม่อย่างละเอียด การนำงานกลับมาเป็น Changes ด้วยวิธีที่เหมาะสมอาจสะดวกกว่า
คำถามที่พบบ่อย
Squash ใน Desktop เหมือน Squash and merge บน GitHub หรือไม่?
ทั้งสองเกี่ยวข้องกับการรวม Commit แต่เกิดคนละขั้นตอน บทความนี้จัดประวัติบน Branch ในเครื่องก่อน Push ส่วน Squash and merge บน GitHub เป็นตัวเลือกขณะรวม Pull Request เข้า Branch ปลายทางเมื่อ Repository อนุญาต
Squash แล้ว Commit เดิมหายถาวรทันทีไหม?
Commit เดิมจะไม่อยู่บนเส้นประวัติใหม่ของ Branch ที่แก้ แต่อาจยังถูกอ้างอิงจาก Branch อื่น เช่น Branch สำรอง จึงไม่ควรมอง Squash เป็นวิธีลบข้อมูลลับออกจากทุกตำแหน่ง
จำเป็นต้องรวมทุก Commit ก่อน Push หรือไม่?
ไม่จำเป็น ให้ดูแนวทางของโปรเจกต์ บางทีมต้องการ Commit ย่อยที่แยกเหตุผลชัดเจน ขณะที่บางทีมรวมงานตอน Merge PR อยู่แล้ว
เช็กลิสต์ก่อนกด Squash Commits
- เลือก Repository และ Branch ถูกต้อง
- ไม่มีงานค้างใน Changes ที่ยังไม่ได้จัดการ
- Commit ที่จะรวมยังไม่ Push และเป็นงานเดียวกัน
- เลือกช่วงงานและ Commit ปลายทางถูกต้อง
- ข้อความใหม่อธิบายผลลัพธ์ครบถ้วน
- ตรวจไฟล์และทดสอบหลังรวม
- ตรวจประวัติบน GitHub หลังส่งงาน
เริ่มฝึกจาก Commit เอกสารเล็ก ๆ ที่เรียงติดกันก่อน เมื่อเห็นว่าเนื้อหาสุดท้ายยังครบแต่ประวัติอ่านง่ายขึ้น คุณจะเลือกใช้ Squash กับงานจริงได้มั่นใจขึ้น โดยยึดจุดประสงค์ของงานและกติกาของทีมเป็นหลัก
Share your thoughts here
Join the conversation and share your perspective on this article.