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 仍可能在同一台機器執行測試。機器資源不足時,測試工作仍然需要排隊。

來源

協作花費審查並行隔離Codex