在日常開發中，你是不是也曾遇過這種窘境：

• 手上正在 main 分支忙著開新功能，結果突然要修 bug。
• 想切去 hotfix 分支，但手邊的修改還沒完成。
• 只好先 git stash、切分支、修 bug、再回來 stash pop… 一整個心累 😩
• 或者乾脆多 clone 一份 repo，桌面亂成一團。

其實 Git 早就幫你想好解方了，那就是 —— git worktree：在同一個 repo 中，開出多個「工作目錄」平行開發！

git worktree 是什麼？

Worktree（工作樹）讓你在同一個 Git 倉庫中建立多個獨立的工作目錄。

每個目錄都可以：

• 檢出不同分支
• 保有獨立的修改、暫存與提交
• 共享相同的 .git 版本資料

可以想成是 Git 的「分身術」 —— 讓你同時存在於多個平行世界，開不同分支卻互不干擾。

建立新的 Worktree

最基本用法：

git worktree add <路徑> <分支名稱>

git worktree add ../feature-login feature/login

說明：

• ../feature-login：新建工作目錄的路徑
• feature/login：要 checkout 的分支（不存在會自動建立）

建立後你會得到這樣的結構：

/project         ← main 分支
/feature-login   ← feature/login 分支

此時可以同時在兩個目錄開發，不會互相干擾

切換現有分支

如果你想把 已有分支 檢出到另一個目錄：

git worktree add ../hotfix hotfix/typo

這樣你就能在 ../hotfix 下開發 hotfix，而不必動 main！

查看所有 Worktree

git worktree list

範例輸出：

/home/user/project         123abc [main]
/home/user/feature-login   456def [feature/login]
/home/user/hotfix          789ghi [hotfix/typo]

每個工作目錄都會顯示：

• 路徑
• commit hash
• 對應分支

一目了然 👍

移除 Worktree

使用完可以安全移除：

git worktree remove ../feature-login

不會影響原始 repo，但請確保該目錄乾淨（沒有未提交變更）

若出現「dead worktree」殘留，可以清理：

git worktree prune

實戰案例：Hotfix 緊急修正不打斷主線

假設你在 main 分支開發，突然發現 typo 需要立刻修正：

# 建立一個 hotfix 分支的 worktree
git worktree add ../hotfix hotfix/typo

# 進入 hotfix 工作樹
cd ../hotfix

# 修正 bug 並提交
git add typo.js
git commit -m "修正拼字錯誤"
git push origin hotfix/typo

這樣就能：

• 不切換 main 分支
• 不用 stash
• 不會干擾正在開發的功能

指令速查表

進階：--detach 模式

如果你想「只看舊版本、不綁分支」——可以用 --detach：

git worktree add --detach ../temp

這會建立一個 detached HEAD 的目錄（不屬於任何分支）。

💡 一句話記住：

• -detach = 純測試、不綁分支、安全實驗用。

Worktree 的特性

• 多分支同時存在

  每個 worktree 各自 checkout 不同分支，彼此獨立。

• 共用 .git，節省空間

  不用多 clone，磁碟負擔更小。

• 自動管理引用

  新增或移除 worktree 會同步更新 .git/worktrees/。

• 安全限制

  同一分支不能被多個 worktree 同時 checkout，避免衝突。

小挑戰 💪

試著在同一個 repo 中：

1. 建立兩個 worktree：feature/login、hotfix/typo
2. 在 feature/login 提交一個 commit
3. 在 hotfix/typo 修正一個小 bug 並 push
4. 回到 main 確認完全不受影響

成功完成，就代表你掌握了 Worktree 的真功夫！

小結

它的優點：

• 不必頻繁切換分支
• 不再依賴 git stash
• 節省空間、提高手速
• 適合多任務、平行開發、快速修 bug

有了 git worktree，你再也不用為「切分支忘 stash」的夢魘驚醒啦 😎