Git worktree 实战：一套仓库并行修 Bug 和开发新功能

平时开发最烦的场景之一，是你正在一个功能分支里改到一半，线上突然来了一个紧急 Bug。直接切分支，工作区有未提交文件；临时 stash，又担心回来时忘记恢复；重新 clone 一份仓库，又浪费空间和时间。

git worktree 很适合解决这种“一个仓库，多份工作区”的问题。它允许同一个 Git 仓库同时挂出多个目录，每个目录检出不同分支。你可以一个目录继续做新功能，另一个目录立刻修 Bug，互不打断。

摘要

本文用“主线开发 + 紧急修复 + 临时验证”的真实工作流，演示 git worktree 的创建、查看、目录规划、删除清理和常见问题。重点不是背命令，而是把它用成稳定的日常开发习惯。

适合人群

适合经常在多个 Git 分支之间切换、同时维护多个需求、需要快速处理线上问题的开发者。你需要已经会使用 git branch、git switch、git status 和基础提交命令。

目录

1. worktree 解决什么问题
2. 推荐的目录组织方式
3. 创建一个紧急修复工作区
4. 查看和进入不同工作区
5. 删除、清理和锁定工作区
6. 常见问题排查
7. 团队使用建议

一、worktree 解决什么问题

普通工作区一次只能检出一个分支。你在 feature/payment 上改到一半时，如果需要切到 main 拉一个修复分支，就会遇到未提交文件、依赖目录变化、IDE 索引重建等干扰。

git worktree 的思路是：仓库对象仍然共用一份，但工作目录可以有多份。每份工作目录对应一个分支，文件互不覆盖。

二、推荐的目录组织方式

不要把所有目录随手散在桌面。推荐固定一个父目录，例如：

projects/
  shop/                 # 主工作区
  shop-hotfix-login/    # 紧急修复工作区
  shop-spike-cache/     # 临时验证工作区

主工作区保留日常功能开发，额外工作区用任务名命名。这样 IDE、终端和文档里都能一眼看出当前目录在做什么。

三、创建一个紧急修复工作区

假设当前目录是主工作区 projects/shop，你正在开发新功能。线上登录出问题，需要从 main 拉一个修复分支：

cd ~/projects/shop

git fetch origin
git worktree add ../shop-hotfix-login -b hotfix/login origin/main

这条命令会创建一个新目录 ../shop-hotfix-login，并基于 origin/main 新建分支 hotfix/login。你的主工作区不会被切走，未提交的新功能代码也不会被碰到。

进入修复目录后，就像普通仓库一样开发、提交、推送：

cd ../shop-hotfix-login
git status

# 修改代码后
git add .
git commit -m "fix: repair login redirect"
git push -u origin hotfix/login

四、查看和进入不同工作区

想知道当前仓库挂了哪些工作区，可以运行：

git worktree list

它会列出每个工作区路径、提交哈希和分支名。日常使用时建议把这个命令当作“工作区看板”，尤其是在多个任务并行时，先确认自己在哪个目录、哪个分支。

五、删除、清理和锁定工作区

修复分支合并后，可以删除对应工作区：

cd ~/projects/shop
git worktree remove ../shop-hotfix-login

如果某个工作区目录是手动删掉的，Git 可能还保留它的元数据。可以用清理命令整理：

git worktree prune

如果某个工作区放在外接硬盘、网络盘或临时挂载目录上，担心清理时被误认为已经失效，可以先锁定它：

git worktree lock ../shop-spike-cache
git worktree unlock ../shop-spike-cache

锁定不是权限控制，它更像是告诉 Git：这个工作区是有意保留的，不要在清理时随便处理。

六、常见问题排查

1. 同一个分支不能同时被两个工作区检出

如果你已经在主工作区检出了 feature/payment，再创建另一个工作区直接使用同名分支，Git 会提示该分支已经被使用。解决方式是给新工作区创建独立分支，或者先切走原工作区。

git worktree add ../shop-payment-test -b feature/payment-test origin/main

2. 删除目录后列表里还有记录

这是因为你绕过了 git worktree remove。先运行 git worktree list 确认，再用 git worktree prune 清理过期记录。

3. 依赖安装目录会重复

工作区文件是独立的，所以 node_modules、vendor、构建产物也会按目录分别存在。大型项目建议把依赖缓存、构建缓存放到工具支持的全局缓存里，减少重复下载。

4. IDE 打开多个目录时容易混淆

建议给每个窗口设置清晰标题，或者使用不同终端主题。提交前看一眼 pwd、git branch --show-current 和 git status，能少很多误操作。

七、团队使用建议

• 给 worktree 目录建立统一命名规则，例如 repo-task-name。
• 紧急修复优先从稳定主线创建新分支，不要从未完成的功能分支上继续改。
• 完成任务后及时 remove，避免本地目录越堆越多。
• 在项目 README 或团队规范里补一段 worktree 使用说明，让新人也能跟上。
• CI、提交规范、代码检查仍然按分支走，worktree 只是本地工作区组织方式。

总结

git worktree 最适合处理多任务并行：新功能不用停，紧急修复能马上开新目录，临时验证也不用污染主工作区。记住三个核心动作就够了：用 git worktree add 创建，用 git worktree list 查看，用 git worktree remove 收尾。把目录命名和清理习惯固定下来，它会成为非常顺手的日常工具。

参考资料

命令语义参考 Git 官方 git-worktree 文档，本文示例和工作流为原创整理。