Git worktree 怎样同时维护两个分支目录

如果你需要同时改 main 和 feature/login，不必复制两份完整仓库，也不必在同一个目录里反复切换分支。用 git worktree add 给第二个分支分配一个新的目录即可：两个目录共享同一个 Git 仓库对象，但各自拥有独立的工作文件和当前分支。

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

先把“两个目录”理解成一个仓库的两个工作树

worktree 不是再克隆一份完整仓库，而是在同一个仓库管理范围内增加一个链接的工作目录。主工作树可以继续处理稳定分支，链接工作树负责另一个分支；文件修改互不覆盖，提交仍然写入同一个仓库的对象数据库。

这个关系适合这样的场景：主目录正在运行回归测试，你又要在另一个分支修登录页；或者一个目录保留发布分支，另一个目录专门处理短期功能。下面假设主目录叫 project-main，目标目录叫 project-login。

在主目录确认仓库状态

先进入当前仓库，确认它确实是 Git 工作树，并记住当前目录和分支。尤其不要把未提交修改误认为会自动同步到第二个目录；worktree 共享仓库元数据，不共享每个目录里的未提交文件内容。

# 进入主工作目录，后续路径都以它为基准
cd /path/to/project-main

# 确认当前目录属于 Git 仓库以及当前分支
git rev-parse --show-toplevel
git branch --show-current

# 创建第二个工作树前先看是否有未提交修改
git status --short

如果 git status --short 输出了你还没准备好的修改，先决定是提交、暂存还是保留。创建第二个工作树本身不会替你处理这些修改。

用一条命令为目标分支创建第二个目录

如果 feature/login 已经存在，直接把分支名放在目录后面：

# 从当前仓库已有的 feature/login 分支创建链接工作树
git worktree add ../project-login feature/login

如果分支还不存在，则用 -b 在创建工作树的同时新建分支，并指定它从哪个起点开始：

# 从 main 创建新分支，并把它检出到相邻目录
git worktree add -b feature/login ../project-login main

这里的 ../project-login 是新目录，feature/login 是该目录的当前分支，最后的 main 是新分支的起点。执行完成后，主目录仍然在原分支，不需要再切换回来。

分别进入两个目录，先用 list 对照路径和分支

创建后不要凭记忆判断目录。回到仓库中的任意工作树执行 git worktree list，它会列出主工作树和链接工作树。这个命令特别适合检查“目录名看起来对，但实际分支不对”的情况。

# 从主工作树查看所有 worktree 的路径、提交和分支
git worktree list

# 进入第二目录，确认它确实检出了功能分支
cd ../project-login
git branch --show-current
git status --short

两个目录可以分别打开编辑器或终端窗口。你在 project-login 中修改和提交，不会让 project-main 的工作文件突然变成另一个分支；但两个工作树仍然属于同一个仓库，所以提交对象和引用管理并不是两套完全独立的仓库。

结束工作时优先 remove，别把 prune 当删除命令

功能分支目录不再需要时，先确认它没有未提交修改，再从仓库中的其他工作树执行 remove。这个动作会注销链接工作树，通常也会删除对应目录；如果目录不干净，Git 会拒绝普通删除，避免误丢本地修改。

# 先从不准备删除的工作树查看目标目录是否干净
cd /path/to/project-main
git -C ../project-login status --short

# 确认无误后注销并移除不再需要的链接工作树
git worktree remove ../project-login

# 最后重新列出工作树，确认只保留仍在使用的目录
git worktree list

如果你已经在文件管理器中手动删掉了 project-login，仓库里可能还残留它的管理信息。这时先列出状态，确认它确实是失效条目，再运行预览模式的 prune，最后才执行清理。

# 预览将要清理的失效 worktree 管理信息，不立即删除
git worktree prune -n -v

# 确认输出只包含已经不存在的目录后再清理残留元数据
git worktree prune -v

分支被占用或目录移动时怎么判断

Git 默认不允许同一个分支同时被两个工作树检出。比如 main 已经在 project-main 中使用，再执行一次把 main 加到第二目录的命令时，Git 会拒绝操作。这层保护是为了避免两个目录同时推进同一个分支引用，通常不应该用 -f 强行绕过。

如果只是想换一个目录位置，优先使用 git worktree move，让 Git 同步更新管理信息：

# 把仍在使用的链接工作树移动到新路径
git worktree move ../project-login ../project-login-local

# 移动后确认路径和分支仍然对应
git worktree list

如果目录已经被外部工具移动，Git 记录的路径可能暂时失效。此时不要一上来删掉仓库元数据，可以在移动后的目录中用 git worktree repair 尝试重新建立连接；只有确认目录已经废弃时，才使用 prune 清理。

常见问题

两个 worktree 能不能使用同一个分支？

默认不能。Git 会阻止同一分支同时在多个工作树中检出；除非你明确理解风险，否则不要用 -f 绕过这项保护。

worktree 和再 clone 一份有什么区别？

worktree 让多个目录挂在同一个仓库管理范围下，适合在本机并行维护分支；独立 clone 则是两份各自管理的仓库。选择哪种方式取决于你是否希望共享仓库对象和分支管理边界。

手动删除第二目录后为什么还会出现在 list 里？

因为目录删除和 Git 的 worktree 管理信息不是同一步。先用 git worktree prune -n -v 预览失效条目，确认后再执行 git worktree prune -v。

实际使用时可以记住一条最短路径：git worktree add 创建第二目录，git worktree list 确认目录和分支，git worktree remove 正常收尾，git worktree prune 只处理手动删除后留下的失效记录。