Git worktree 怎样并行处理多个分支

需要同时修复线上分支、开发新功能时，频繁 stash 和 checkout 很容易把工作状态搅在一起。Git worktree 的做法是让同一个仓库拥有多个工作目录：每个目录有自己的 HEAD 和 index，但共享对象数据库。这样可以在不同目录分别打开不同分支，互不覆盖未提交文件。

官方文档：https://git-scm.com/docs/git-worktree

先确认主工作树和目录规划

建议把并行目录放在主仓库同级，例如主目录是 demo-app，临时修复目录可以放成 ../demo-app-hotfix。先在主工作树运行列表命令，确认没有重复路径或已经占用的分支。

# 列出主工作树、链接工作树、提交和分支
git worktree list

# 用机器可读格式查看路径与分支关系
git worktree list --porcelain

列表中的第一项通常是主工作树，后续项是 linked worktree。规划时不要把一个分支同时分配给两个目录；Git 默认会阻止这种检出，以免两个 index 互相覆盖未提交文件。

用 add 创建可并行的新分支

如果任务还没有分支，可以直接用 -b 指定分支名和路径。命令从当前 HEAD 创建分支，并在新目录完成检出。

# 在仓库同级创建 hotfix 目录，并从当前提交创建新分支
git worktree add -b hotfix/login ../demo-app-hotfix

# 进入新目录，后续修改只落在 hotfix 工作树
cd ../demo-app-hotfix

# 查看当前目录实际检出的分支
git branch --show-current

看到 hotfix/login 就说明入口和分支都正确。此时回到主目录继续开发，两个目录的未提交文件不会互相覆盖；提交仍然写入同一个仓库历史。

已有分支用第二个目录打开

已有分支不需要重新创建，直接把分支名放在路径后面即可。若它已经被另一个 worktree 检出，Git 会拒绝操作，这不是目录权限问题，而是分支占用保护。

# 将已经存在的 review 分支检出到独立目录
git worktree add ../demo-app-review review

# 回到主工作树查看所有目录和分支
cd ../demo-app
git worktree list

可以把“一个目录对应一个当前分支”作为简单规则。多个 worktree 共享对象和历史，目录自身的 HEAD、index 与工作文件各自维护；因此在一个目录暂存文件，不会让另一个目录的暂存区同步变化。

remove 清理工作树并保留仓库历史

任务结束后，先在目标目录提交或转移需要保留的修改，再从主工作树执行移除。干净的工作树可以直接删除；包含未提交修改时，Git 会提醒你先处理，只有确认放弃才使用强制参数。

# 从主工作树移除已经完成的 hotfix 工作目录
git worktree remove ../demo-app-hotfix

# 复查剩余工作树，确认 hotfix 已经消失
git worktree list

# 目录被手动删除后，再清理失效的管理记录
git worktree prune

prune 适合处理“目录已经没了、Git 记录还在”的遗留情况，但正常流程仍应优先使用 remove。不要把 remove -f 当成快捷删除，它可能丢掉目标目录中的未提交内容。

常见问题

worktree 会复制一份完整仓库吗？

不会。链接工作树共享仓库对象和历史，但分别保存 HEAD、index 与工作文件，所以节省重复对象空间。

为什么 add 已有分支会失败？

通常是该分支已被另一个工作树检出。先用 git worktree list 找到占用目录，再决定继续使用、移除旧目录或换一个分支。

直接删除目录后还要做什么？

回到仍存在的工作树执行 git worktree prune，清理失效的管理记录；能正常结束时优先使用 git worktree remove。