Git Worktrees

ทำงานกับหลายบราน์ชพร้อมกันได้โดยไม่ต้อง stash — แต่ละบราน์ชอยู่ในโฟลเดอร์ของตัวเอง และสลับได้จากแถบสถานะ

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

Git Worktree คืออะไร?

โดยปกติ Git repository จะมี working directory เพียงหนึ่งเดียว คือโฟลเดอร์ที่เก็บไฟล์ของคุณ และในแต่ละขณะจะมีเพียงหนึ่งบราน์ชที่ถูก checkout อยู่ในโฟลเดอร์นั้น หากต้องการดูอีกบราน์ชหนึ่ง คุณต้อง checkout ซึ่งจะแทนที่ไฟล์ของคุณด้วยเวอร์ชันของบราน์ชนั้น และถ้ายังไม่ได้ commit งานปัจจุบัน คุณก็ต้อง stash ก่อน ซึ่งทั้งน่ารำคาญและพลาดง่าย

Worktree คือ working directory ที่สอง (หรือสาม หรือสี่) ที่เชื่อมโยงกับ Git repository เดียวกัน แต่ละ worktree มีบราน์ชที่ checkout ไว้ สถานะไฟล์ และประวัติเป็นของตัวเอง ทั้งหมดใช้โฟลเดอร์ .git และประวัติ commit ร่วมกัน เป็นเพียงหน้าต่างคนละบานที่มองเข้าไปใน repo เดียวกัน

ตัวอย่างที่เป็นรูปธรรม: AI agent ของคุณกำลังสร้างฟีเจอร์ใหม่บน feature/payments ไปได้ครึ่งทาง เพื่อนร่วมงานขอให้คุณรีวิว PR ของเขาบน fix/login-bug แทนที่จะ stash งานฟีเจอร์ของคุณ คุณสร้าง worktree สำหรับ fix/login-bug ในโฟลเดอร์แยก แล้วรีวิว PR ที่นั่น ส่วนบราน์ชฟีเจอร์ของคุณยังคงอยู่ในโฟลเดอร์เดิมโดยไม่ถูกแตะต้อง

สร้าง Worktree

  1. เปิด Git panel — กด Cmd+G
  2. คลิกแท็บ Worktrees ที่ด้านบนของแผง
  3. คลิก + Add Worktree
  4. เลือกบราน์ช — จะเลือกบราน์ชที่มีอยู่จากรายการ หรือพิมพ์ชื่อบราน์ชใหม่เพื่อสร้างก็ได้
  5. เลือกตำแหน่งโฟลเดอร์สำหรับ worktree ใหม่ (โดยค่าเริ่มต้น 1DevTool จะแนะนำโฟลเดอร์ที่อยู่ข้างโฟลเดอร์โปรเจกต์ปัจจุบันของคุณ)
  6. คลิก Create — 1DevTool จะรัน git worktree add และเปิดโฟลเดอร์ worktree ใหม่เป็น workspace ที่ใช้งานอยู่

ตอนนี้ worktree ใหม่จะแสดงอยู่ในแท็บ Worktrees ควบคู่กับ main worktree ของคุณ

Git worktree

เทอร์มินัลของ Worktree

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

AI agent ในเทอร์มินัลนั้นทำงานอยู่ในโฟลเดอร์ของ worktree — อ่านและเขียนไฟล์ รันคำสั่ง และแก้ไขบนบราน์ชนั้นได้ โดยไม่รับรู้หรือรบกวนบราน์ชอื่นของคุณเลย

Add terminal for git worktree

Git worktree terminal with branch name

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

สลับ Worktree จากแถบสถานะ

เมื่อโปรเจกต์มี worktree ที่เชื่อมโยงอยู่ แถบสถานะจะแสดงชื่อ checkout ที่ใช้งานอยู่ถัดจากชิปบราน์ช พร้อมสี และเครื่องหมาย primary, locked และ dirty และสลับระหว่างกันได้โดยไม่ต้องเปิด Git Client

ตัวเลือก worktree บนแถบสถานะ พร้อมสถานะว่าง No terminal in this worktree และ file explorer ที่จำกัดขอบเขตอยู่ที่ checkout นั้น

มีสองอย่างที่ทำให้การสลับไปลงตรงจุดที่คุณคาดไว้:

  • เทอร์มินัลที่เป็นของ worktree นั้นจะขึ้นมาอยู่ด้านหน้า คุณจะไม่ถูกทิ้งไว้ที่แท็บของ checkout อื่น ซึ่งเป็นสาเหตุที่พบบ่อยที่สุดที่ทำให้คำสั่งถูกรันผิด tree
  • worktree ที่ว่างจะบอกให้รู้ checkout ที่ไม่มีเทอร์มินัลให้เห็นจะแสดง No terminal in this worktree และปุ่ม Add terminal in this worktree แทนที่จะเป็นแผงที่ค้างมาจากที่อื่น

file explorer ก็ตาม worktree ที่ใช้งานอยู่เช่นกัน tree ที่คุณกำลังเรียกดูจึงตรงกับ tree ที่คำสั่งของคุณรันอยู่

ลบ Worktree

เมื่อคุณใช้ worktree เสร็จแล้ว — PR ถูก merge และบราน์ชถูกลบแล้ว — คุณสามารถลบมันออกได้อย่างสะอาดหมดจด:

  1. เปิด Git panel แล้วไปที่แท็บ Worktrees
  2. หา worktree ที่ต้องการลบ
  3. คลิก ไอคอนถังขยะ ที่อยู่ข้างๆ
  4. ยืนยันการลบ

การทำเช่นนี้จะลบโฟลเดอร์ worktree และยกเลิกการลงทะเบียนจาก Git (เทียบเท่ากับ git worktree remove) ตัวบราน์ชเองจะไม่ถูกลบ ลบเพียง working directory เท่านั้น และคุณสร้าง worktree ขึ้นใหม่ภายหลังได้หากจำเป็น

เคล็ดลับ: ใช้ worktrees เพื่อรัน AI agent บนบราน์ชฟีเจอร์ ขณะที่ main ยังคงเสถียร agent จะไม่ทำให้บราน์ช main ของคุณเสียหายโดยบังเอิญ

Worktrees เป็นหนึ่งในฟีเจอร์ของ Git ที่ถูกใช้น้อยเกินไป ในบริบทของการพัฒนาที่มี AI ช่วย ซึ่ง agent อาจแก้ไขไฟล์หลายสิบไฟล์ในเวลาไม่กี่นาที การแยกงานของ agent แต่ละตัวไว้ในบราน์ชและโฟลเดอร์ของตัวเองจึงเป็นตาข่ายนิรภัยที่สำคัญ