Git worktree 怎么把现有分支签出到独立目录

想把一个已经存在的 Git 分支放到另一个目录里继续开发，核心命令是：

# 把已有分支签出到仓库旁的独立目录
git worktree add ../demo-review feature/review

这里的 feature/review 是已有分支，../demo-review 是新工作目录。命令成功后，主目录仍停留在原分支，新目录独立拥有自己的工作区和 HEAD，但对象数据仍由同一个仓库共享。官方地址：https://git-scm.com/docs/git-worktree

步骤一：确认目标分支和目录位置

先进入仓库主工作树，确认目标分支确实存在，并查看当前已经登记的工作树。这个检查能避免把新目录写到错误位置，也能提前发现同一分支已经被占用。

# 查看当前主工作树所在分支
git branch --show-current

# 查看本地分支，确认 feature/review 存在
git branch --list

# 查看所有主工作树和链接工作树
git worktree list

核对标准是：git branch --list 中能找到目标分支，准备使用的目录没有出现在 git worktree list 中。如果列表里已经有 feature/review，先判断那是不是正在使用的目录，不要直接强制重复签出。

步骤二：用 git worktree add 签出现有分支

在主工作树执行创建命令。已有分支写在路径之后，Git 会把它直接绑定到新工作树；-b 是“创建新分支”的选项，本题不需要。

# 创建独立目录，并直接签出已存在的 feature/review 分支
git worktree add ../demo-review feature/review

# 进入新目录，确认它看到的是目标分支
cd ../demo-review
git branch --show-current

创建成功后，第二条检查命令应输出 feature/review。如果 Git 提示分支已被其他工作树使用，优先回到步骤一检查占用情况；--force 可以绕过保护，但会让两个工作目录同时指向同一分支，容易互相覆盖提交，不适合作为常规方案。

步骤三：核对路径和分支绑定

不要只看命令返回的成功提示。用机器可读的列表和新目录自身的状态再核对一次，这一步能确认“目录对了”和“分支对了”是同一件事。

# 用稳定格式列出每个工作树的路径、HEAD 和分支
git worktree list --porcelain

# 从新目录检查当前分支与未提交文件
git -C ../demo-review branch --show-current
git -C ../demo-review status --short

--porcelain 输出中应出现一个对应 ../demo-review 的 worktree 项，以及目标分支的 branch refs/heads/feature/review。status --short 没有输出表示目录干净；有输出也不一定是错误，只要这些改动是你预期的即可。

步骤四：完成工作后移除独立工作树

工作结束后，先处理新目录中的改动，再从主工作树删除链接。删除工作树不会删除分支本身，分支上的提交仍然保留。

# 先确认新目录没有遗漏的未提交改动
git -C ../demo-review status --short

# 从主工作树移除已完成的链接工作树
git worktree remove ../demo-review

# 检查是否还残留失联记录；仅在确有需要时清理
git worktree prune

如果 remove 因未提交文件拒绝执行，先提交、备份或转移这些改动。只有确认内容可以丢弃时，才考虑 git worktree remove --force ../demo-review；强制删除只处理工作树目录，不应被当作保存代码的方式。

常见问题

为什么不能把同一个分支同时签出两次？

Git 默认阻止这种操作，是为了避免两个目录分别提交后让同一分支引用产生难以判断的推进关系。需要并行查看代码时，可以在第二个目录使用 detached HEAD；需要继续开发时，最好为第二个任务建立不同分支。

新目录和主目录会不会复制两份完整对象数据？

不会。链接工作树共享同一个仓库的对象和大部分元数据，但每个工作树拥有独立的 HEAD、索引和工作区文件，所以可以同时打开两个目录。

手动删除目录后为什么列表里还有它？

手动删除绕过了 Git 的登记流程，仓库可能暂时保留失联记录。先运行 git worktree list 确认路径，再用 git worktree prune 清理无效记录；以后优先使用 git worktree remove。

记住一条最短路径：先用 git worktree list 查清占用，再用 git worktree add 新目录 已有分支 创建，最后用同一个列表和 git -C 核对结果。