---
site: "zyx.tw"
title: "git worktree 隔離檔案，測試資源仍要另外安排"
description: "每個 agent 使用自己的工作目錄，測試仍須檢查共用資源。"
url: "https://www.zyx.tw/map/fleet/isolate-parallel-work"
---

# git worktree 隔離檔案，測試資源仍要另外安排

紀錄 059，深讀 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 分支的檔案。

```text
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
```

Figure: Commands that give one repository two more working directories, each on its own branch, and remove one after its branch is merged.

1. Add: 每個指令建立一個新目錄，並開一個新分支。
2. Layout: 三個目錄共用同一份 Git 紀錄，檔案各自獨立。
3. Remove: 分支合併後，移除對應的目錄。

## 修改留在各自目錄，commit 寫回同一個倉庫

完成一個段落後，用 commit 把修改記進 Git。各目錄的 commit 都寫進同一個倉庫；尚未 commit 的修改則留在各自的工作目錄。

目錄分開後，分支合併時仍可能有衝突，需要另外處理。範例中的 git worktree remove ../app-fix-login 放在合併之後，處理的是工作目錄的收尾。

## 執行測試前，另查連接埠與資料庫

git worktree 只隔離檔案，連接埠與資料庫仍然共用。不能用工作目錄已建立來判定隔離完成，還要另外確認連接埠與資料庫是否仍由多項工作共用。

即使測試讀取不同目錄，多個 agent 仍可能在同一台機器執行測試。機器資源不足時，測試工作仍然需要排隊。

## 來源

- [git-worktree](https://git-scm.com/docs/git-worktree), Git documentation
- [Common workflows](https://code.claude.com/docs/en/common-workflows), Claude Code docs

## 地圖

- 先讀：[我按合計用量決定是否並行，不確定就逐項完成](https://www.zyx.tw/map/fleet/many-at-once.md)
- 回到：[協作](https://www.zyx.tw/map.md)
