https://dev.tldrlss.com/th/tags/git-worktree/ Recent content in Git Worktree on Dev TLDRLSS Hugo -- gohugo.io th Sat, 08 Aug 2026 08:29:00 +0800 https://dev.tldrlss.com/th/article/2026/08/git-worktrees-branch-guide-multi-thread-workflow/ Sat, 08 Aug 2026 08:29:00 +0800 https://dev.tldrlss.com/th/article/2026/08/git-worktrees-branch-guide-multi-thread-workflow/ <img src="https://dev.tldrlss.com/global-assets/images/app/git-1.jpg" alt="Featured image of post ทำไมต้อง git stash ทุกครั้งที่สลับสาขา? Git Worktree คืออะไร? Git Worktree ต่างจาก Git Branch อย่างไร? วิธีใช้ Git Worktree สร้างกระบวนการพัฒนา Multi-thread ประสิทธิภาพสูง" /><p>คุณเคยเจอสถานการณ์แบบนี้ไหม? กำลังพัฒนารีเจอร์ใหม่ที่ซับซ้อน แต่จู่ๆ ก็มี Bug ด่วนเข้ามาที่ต้องแก้ไขทันที</p> <p>เพื่อสลับสาขา (Branch) คุณต้องจำใจใช้ <code>git stash</code> เพื่อซ่อนโค้ดที่ทำค้างไว้ หลังจากแก้ Bug เสร็จและสลับกลับมา คุณต้องคอยระวังเมื่อใช้ <code>git stash pop</code> ซึ่งบางครั้งอาจต้องเจอกับฝันร้ายของการขัดแย้งของโค้ด (Conflict)</p> <p>ในความเป็นจริง <code>Git</code> มีเครื่องมือทรงพลังที่ช่วยแก้ปัญหานี้มานานแล้ว นั่นคือ <code>Git Worktree</code></p> <blockquote> <p><strong>บอกลาการสลับสาขาและการ Stash ที่วุ่นวาย แล้วเริ่มต้นการพัฒนาแบบ Multi-thread ด้วย Worktree</strong></p> </blockquote> <p>บทความนี้จะพาคุณไปทำความเข้าใจกลไกหลักและการใช้งานจริงในทางปฏิบัติ</p> <h2 id="git-worktree-แตกตางจาก-git-branch-อยางไร">Git Worktree แตกต่างจาก Git Branch อย่างไร? </h2><p>เพื่อทำความเข้าใจ <code>Git Worktree</code> ให้เราเริ่มจากทำความเข้าใจความแตกต่างระหว่างมันกับ <code>Git Branch</code> ก่อน</p> <p>เราสามารถเปรียบเทียบการควบคุมเวอร์ชันเหมือนการอ่านหนังสือ:</p> <ul> <li><code>Commit</code> คือ <strong>เวอร์ชันของหนังสือ</strong></li> <li><code>Branch</code> คือ <strong>ที่คั่นหนังสือในหน้าเฉพาะ</strong></li> <li><code>Worktree</code> คือ <strong>โต๊ะทำงานที่คุณกางหนังสือออก</strong></li> </ul> <p>ในวิธีการแบบดั้งเดิม เรามีโต๊ะทำงานเพียงตัวเดียว เมื่อใดก็ตามที่ต้องการสลับที่คั่นหนังสือ เราต้องเก็บเอกสารทั้งหมดที่กำลังแก้ไขอยู่บนโต๊ะหรือซ่อนไว้ในเก๊ะ (ซึ่งก็คือ <code>git stash</code>)</p> <p>แต่ <code>Git Worktree</code> ช่วยให้คุณมี <strong>โต๊ะทำงานที่เป็นอิสระ</strong> หลายตัวพร้อมกัน</p> <table> <thead> <tr> <th>รายการเปรียบเทียบ</th> <th>Git Branch</th> <th>Git Worktree</th> </tr> </thead> <tbody> <tr> <td><strong>แนวคิด Workspace</strong></td> <td>แชร์ไดเรกทอรีทำงานทางกายภาพเดียว</td> <td><strong>มีไดเรกทอรีทำงานทางกายภาพที่เป็นอิสระหลายแห่ง</strong></td> </tr> <tr> <td><strong>ต้นทุนการสลับ</strong></td> <td>ต้องทำการ Commit, Stash หรือพักการเปลี่ยนแปลง</td> <td><strong>ไม่ต้อง Stash เพียงแค่เปลี่ยนไดเรกทอรีก็สลับได้ทันที</strong></td> </tr> <tr> <td><strong>ความปลอดภัยและการแยกส่วน</strong></td> <td>ไฟล์ที่ยังไม่ได้ Commit อาจเกิดข้อขัดแย้งหรือค้างอยู่</td> <td><strong>ไดเรกทอรีถูกแยกออกอย่างสมบูรณ์ ไม่รบกวนซึ่งกันและกัน</strong></td> </tr> <tr> <td><strong>ประวัติการทำงาน</strong></td> <td>แชร์ประวัติ Git Commit และ Branch ร่วมกัน</td> <td><strong>แชร์ประวัติ Git Commit และ Branch ร่วมกัน</strong></td> </tr> </tbody> </table> <p>Branch ปัจจุบัน, Staging Area และไฟล์ที่ยังไม่ได้ Commit ของแต่ละ Worktree จะแยกออกจากกันโดยสิ้นเชิง แต่พวกมันจะ <strong>แชร์ประวัติ Commit และบันทึก Branch ทั้งหมดร่วมกัน</strong></p> <blockquote> <p><strong>Branch คือที่คั่นหนังสือเวอร์ชัน ส่วน Worktree คือโต๊ะทำงานจริง</strong></p> </blockquote> <p>ด้วยวิธีนี้ เมื่อคุณต้องการสลับงาน คุณเพียงแค่เปิดไดเรกทอรีโฟลเดอร์อื่น โดยไม่ต้องแตะต้องสถานะการพัฒนาในปัจจุบันเลย</p> <!--adsense--> <h2 id="เรมตนใชงาน-git-worktree-อยางไร">เริ่มต้นใช้งาน Git Worktree อย่างไร? </h2><p>เมื่อนำ <code>Git Worktree</code> มาใช้ในโปรเจกต์จริง การวางแผนไดเรกทอรีที่ดีจะช่วยให้การพัฒนาราบรื่นยิ่งขึ้น</p> <p>ขอแนะนำให้รักษาไดเรกทอรีโปรเจกต์ที่ <code>git clone</code> มาแต่แรกให้เป็นสำนักงานใหญ่ <code>main</code> ที่สะอาด และวางไดเรกทอรี Worktree ที่สร้างขึ้นใหม่ไว้ภายนอกโปรเจกต์ (เช่น <code>../my-app-worktrees</code>) เพื่อป้องกันข้อผิดพลาดจากการที่เครื่องมือพัฒนาสแกนโฟลเดอร์แบบวนซ้ำ</p> <p>ขั้นตอนคำสั่งที่ใช้บ่อยมีดังนี้:</p> <table> <thead> <tr> <th>ขั้นตอน</th> <th>คำสั่ง</th> </tr> </thead> <tbody> <tr> <td>1. สร้าง Worktree ใหม่พร้อมสร้าง Branch ใหม่</td> <td><code>git worktree add ../my-app-worktrees/feature-login -b feature-login</code></td> </tr> <tr> <td>2. ดูรายการ Worktree ทั้งหมดในปัจจุบัน</td> <td><code>git worktree list</code></td> </tr> </tbody> </table> <p><code>Git Worktree</code> เหมาะเป็นอย่างยิ่งสำหรับการจัดการงานพัฒนาของ <code>AI Agent</code></p> <p>คุณสามารถมอบไดเรกทอรี Worktree ที่เป็นอิสระให้กับ <code>AI Agent</code> เพื่อแก้ไขและทดสอบได้อย่างเต็มที่ ในขณะที่นักพัฒนาที่เป็นมนุษย์สามารถทำการตรวจสอบโค้ด (Review) และทดสอบในอีก Worktree หนึ่งได้</p> <blockquote> <p><strong>มอบ Worktree ที่เป็นอิสระให้ AI Agent เพื่อให้การพัฒนาด้วย AI และการตรวจสอบโดยมนุษย์ดำเนินไปพร้อมกันได้</strong></p> </blockquote> <p>ทั้งสองทำงานในไดเรกทอรีทางกายภาพของตนเอง ซึ่งปลอดภัยและชัดเจน</p> <h2 id="รวมโคดและทำความสะอาดอยางปลอดภยหลงจากพฒนาเสรจไดอยางไร">รวมโค้ดและทำความสะอาดอย่างปลอดภัยหลังจากพัฒนาเสร็จได้อย่างไร? </h2><p>หลังจากที่คุณพัฒนางานใน Worktree ที่เป็นอิสระเสร็จสิ้นแล้ว จะรวมผลงานและทำความสะอาดอย่างไร?</p> <blockquote> <p>โปรดจำแนวคิดสำคัญไว้: ตัวไดเรกทอรี Worktree เองไม่จำเป็นต้องรวม <strong>สิ่งที่ต้องรวมจริงๆ คือ Branch</strong></p> </blockquote> <p>คุณเพียงแค่กลับไปที่ไดเรกทอรีโต๊ะทำงาน <code>main</code> และรันคำสั่ง <code>git merge</code> กับ Branch ฟีเจอร์ที่เกี่ยวข้องเพื่อเสร็จสิ้นการรวมโค้ด</p> <p>สำหรับการทำความสะอาด โปรดทำตามขั้นตอนมาตรฐาน 2 ขั้นตอน:</p> <table> <thead> <tr> <th>ขั้นตอน</th> <th>คำสั่ง</th> </tr> </thead> <tbody> <tr> <td>1. ลบไดเรกทอรีทางกายภาพของ Worktree</td> <td><code>git worktree remove ../my-app-worktrees/feature-login</code></td> </tr> <tr> <td>2. ลบ Branch ฟีเจอร์ที่เสร็จสมบูรณ์แล้ว</td> <td><code>git branch -d feature-login</code></td> </tr> </tbody> </table> <blockquote> <p><strong>ลบไดเรกทอรี Worktree ก่อน แล้วจึงลบ Branch</strong></p> </blockquote> <p>โปรดใช้คำสั่ง <code>git worktree remove</code> ในการทำความสะอาดเสมอ อย่าลบโฟลเดอร์ด้วยตนเองในตัวจัดการไฟล์</p> <!--adsense--> <h2 id="กบดกทพบบอยเมอใช-git-worktree-มอะไรบาง">กับดักที่พบบ่อยเมื่อใช้ Git Worktree มีอะไรบ้าง? </h2><p>แม้ว่า <code>Git Worktree</code> จะสะดวกมาก แต่มีกับดักบางอย่างที่ต้องระวังเป็นพิเศษ</p> <h3 id="กบดกท-1-การเปลยนแปลงทยงไมได-commit-จะสญหาย">กับดักที่ 1: การเปลี่ยนแปลงที่ยังไม่ได้ Commit จะสูญหาย </h3><p>แม้ว่าการลบ Worktree จะไม่ลบ Branch แต่หากคุณยังมีการเปลี่ยนแปลงที่ไม่ได้ commit ในไดเรกทอรีนั้น การลบไดเรกทอรี Worktree แบบบังคับจะทำให้การเปลี่ยนแปลงเหล่านั้นสูญหายไปทันที</p> <h3 id="กบดกท-2-ความขดแยงจากการยดครอง-branch">กับดักที่ 2: ความขัดแย้งจากการยึดครอง Branch </h3><p>กลไกการป้องกันของ <code>Git</code> <strong>ไม่อนุญาตให้ Checkout Branch เดียวกันใน Worktree สองแห่งพร้อมกัน</strong> หากคุณพยายามสลับไปยัง Branch ที่ถูกใช้งานอยู่แล้วใน Worktree ที่สอง <code>Git</code> จะบล็อกและแสดงข้อความแสดงข้อผิดพลาดทันที</p> <blockquote> <p><strong>การลบ Worktree แบบบังคับจะทำให้สูญเสียการเปลี่ยนแปลงที่ยังไม่ได้ Commit</strong></p> </blockquote> <p>เพียงแค่เข้าใจคุณลักษณะและหลักการเหล่านี้ คุณก็จะสามารถหลีกเลี่ยงข้อผิดพลาดได้</p> <h2 id="บทสรป">บทสรุป </h2><p>ด้วย <code>Git Worktree</code> เราสามารถบอกลาการสลับสาขาที่วุ่นวายและกระบวนการ <code>git stash</code> ได้อย่างสิ้นเชิง และบรรลุการพัฒนาแบบ Multi-thread ที่แท้จริง</p> <p>ครั้งต่อไปที่คุณต้องแก้ Bug ด่วน, พัฒนาหลายฟีเจอร์พร้อมกัน หรือมอบหมายงานเขียนโค้ดให้ <code>AI Agent</code> ลองเปิดโต๊ะทำงานใหม่ดูนะครับ!</p> <!--adsense--> <h2 id="reference">Reference </h2><ul> <li><a class="link" href="https://git-scm.com/docs/git-worktree" target="_blank" rel="noopener" >Git - git-worktree Documentation</a></li> </ul>