git worktree 隔離檔案,測試資源仍要另外安排
深讀 L2 532 字 1 分鐘 v1.0.0 更新 2026-11-16
並行工作的隔離有兩層:各自修改的檔案,以及測試使用的資源。 每個 agent 需要自己的工作目錄,但分開目錄不代表測試環境也已分開。
Git 是記錄檔案修改的工具,專案放在 Git 倉庫裡。git worktree 讓同一個倉庫有多個工作目錄。
兩個 agent 在同一個目錄改檔案,修改會互相覆蓋。測試也會讀到對方改到一半的程式,因此隔離要在開始修改之前安排。
先建立工作目錄,再分配修改工作
每個工作目錄各有自己的檔案與分支。
git worktree add ../app-fix-login -b fix-login git worktree add ../app-new-page -b new-page # one repository, three working directories # app/ main # app-fix-login/ fix-login # app-new-page/ new-page git worktree remove ../app-fix-login # after the merge
圖中的每個 git worktree add 指令建立一個新目錄,並開出一個新分支。
接著,讓負責登入修改的 agent 在 app-fix-login/ 工作,負責新頁面的 agent 在 app-new-page/ 工作。原本的 app/ 則保留對應 main 分支的檔案。
每個指令建立一個新目錄,並開一個新分支。
修改留在各自目錄,commit 寫回同一個倉庫
完成一個段落後,用 commit 把修改記進 Git。各目錄的 commit 都寫進同一個倉庫;尚未 commit 的修改則留在各自的工作目錄。
目錄分開後,分支合併時仍可能有衝突,需要另外處理。範例中的 git worktree remove ../app-fix-login 放在合併之後,處理的是工作目錄的收尾。
執行測試前,另查連接埠與資料庫
git worktree 只隔離檔案,連接埠與資料庫仍然共用。不能用工作目錄已建立來判定隔離完成,還要另外確認連接埠與資料庫是否仍由多項工作共用。
即使測試讀取不同目錄,多個 agent 仍可能在同一台機器執行測試。機器資源不足時,測試工作仍然需要排隊。
來源
- git-worktree Git documentation
- Common workflows Claude Code docs