Git Worktree 完整指南：讓多人（或多個 AI）同時開發同一專案

為什麼你需要 Git Worktree？

開發團隊常遇到這個問題：

• 正在開發 Feature A，突然要修 Bug
• 切換分支後，IDE 要重新載入
• npm install 又跑一次
• 原本的工作進度被打斷

Git Worktree 解決這個問題——讓你同時擁有多個工作目錄，每個目錄對應不同分支，互不干擾。

Git Worktree 是什麼？

簡單說：一個 .git，多個工作目錄。

傳統做法是 clone 多份專案，但這樣會：

• 浪費硬碟空間（每份都有完整的 .git）
• 分支之間不同步
• 管理困難

Worktree 則是共享同一個 .git 資料庫，只建立不同的工作目錄。就像同一棟大樓的不同房間，共用水電管線，但各自獨立。

基本指令：3 分鐘上手

建立 Worktree

# 先建立分支
git branch feature-login

# 建立 worktree（在上層目錄）
git worktree add ../myproject-login feature-login

現在你有兩個目錄：

• myproject/ — 主目錄（main 分支）
• myproject-login/ — 工作目錄（feature-login 分支）

查看所有 Worktree

git worktree list

刪除 Worktree

# 開發完成後清理
git worktree remove ../myproject-login

實戰應用：3 個功能同時開發

假設你的團隊要同時開發：

1. 用戶登入功能
2. 聊天室功能
3. 修復結帳頁 Bug

傳統做法：排隊等待，一個做完換下一個。

Worktree 做法：三個人各自在自己的目錄開發，最後合併。

# 建立三個 worktree
git worktree add ../project-login feature/login
git worktree add ../project-chat feature/chat
git worktree add ../project-bugfix bugfix/checkout

# 每個人進入自己的目錄開發
cd ../project-login   # 工程師 A
cd ../project-chat    # 工程師 B
cd ../project-bugfix  # 工程師 C

目錄結構一目瞭然

myproject/                # 主目錄 (main)
├── .git/                 # 共享的 git 資料庫
└── src/

myproject-login/          # Worktree 1 (feature/login)
└── src/                  # 工程師 A 的工作區

myproject-chat/           # Worktree 2 (feature/chat)
└── src/                  # 工程師 B 的工作區

myproject-bugfix/         # Worktree 3 (bugfix/checkout)
└── src/                  # 工程師 C 的工作區

合併流程

各自完成後，回到主目錄合併：

cd myproject

# 合併各分支
git merge feature/login
git merge feature/chat
git merge bugfix/checkout

# 清理 worktree
git worktree remove ../myproject-login
git worktree remove ../myproject-chat
git worktree remove ../myproject-bugfix

Worktree 的三大優勢

1. 節省空間

不用 clone 多份專案，所有 worktree 共享同一個 .git 目錄。

2. 分支永遠同步

因為是同一個 repository，fetch 一次全部更新。

3. 隨時切換情境

不用 stash、不用 commit WIP，直接換到另一個目錄繼續工作。

進階應用：搭配 AI 開發工具

Git Worktree 搭配 AI 程式助手（如 Claude Code、GitHub Copilot）時特別有用：

• 每個 worktree 開一個 AI 對話
• AI 在各自的目錄獨立工作
• 三個功能同時開發，開發速度提升 3 倍

這就是「平行開發」的真正威力——不是讓一個人做三件事，而是讓三個工作環境同時運作。

常見問題

Q: 同一個分支可以有多個 worktree 嗎？

不行。每個分支同時只能對應一個 worktree，避免衝突。

Q: Worktree 和 clone 的差別？

Clone 是完整複製，Worktree 是共享 .git。Worktree 更省空間、更好管理。

Q: 可以在 worktree 裡建立新分支嗎？

可以，就像在一般 repository 操作一樣。

總結

Git Worktree 是一個被低估的功能。它讓你：

• 同時處理多個任務，不用頻繁切換分支
• 團隊成員各自在獨立環境開發
• 搭配 AI 工具實現真正的平行開發

下次當你需要同時開發多個功能時，試試 git worktree add，你會發現開發效率明顯提升。