Git worktree 删除已合并工作区时如何检查主工作树

平时我们用 Git worktree 管理多并行工作副本，清理已经合并完的工作区时，想要检查主工作树的状态，不用手动翻提交记录挨个比对，靠 Git 自带的内置命令就能一步步完成校验。 正常清理已合并工作区前，先确认主工作树的路径绑定有效，再核对待删工作区的提交确实已经并入主工作树的目标分支，最后走删除流程就不会误删还没归档的代码。

平时用 Git worktree 并行开发多个分支时，清理已合并的临时工作区，最容易出错的是分不清关联仓库根目录的主工作树。先用 Git 原生命令确认路径和分支，再处理删除动作，就不会把主工作树和未提交代码混在一起。

直接执行 git worktree list 输出的第一条结果默认就是主工作树，后续挂载的链接工作区会排在列表后面。

官方地址：https://git-scm.com/docs/git-worktree

先把主工作树和候选工作区分清

VS Code 中可以打开“源代码管理”视图的“存储库”区域查看多个 worktree；更稳妥的确认仍然来自仓库根目录的命令。不要在待删除的链接工作树里执行清理命令，否则容易把当前上下文和目标路径混在一起。

# 在主工作树中列出路径、提交、分支和锁定状态
git worktree list --verbose

# 只查看当前主目录，确认它确实属于预期仓库
git rev-parse --show-toplevel

把输出中的第一行记为主工作树，例如 /work/app；后面的 /work/app-review、/work/app-fix 才是待判断的链接工作树。列表中若出现 locked，说明它被保护，不能直接移动或删除。

确认分支已合并，顺便检查未提交文件

假设候选目录是 /work/app-review，分支是 feature/review-panel，主分支是 main。先看工作区是否干净，再判断合并关系。这里的“已合并”指候选分支的尖端提交是 main 的祖先，不是目录名字里写着 merged。

# 在候选工作树中检查分支和未提交改动
git -C /work/app-review branch --show-current
git -C /work/app-review status --short

# 返回码为 0 表示候选分支已包含在 main 的提交历史中
git -C /work/app merge-base --is-ancestor feature/review-panel main
echo "合并检查返回码：$?"

status --short 没有输出且合并检查返回 0，才进入删除步骤。若看到修改、未跟踪文件或子模块状态，先在该 worktree 提交、备份或明确放弃；不要为了让命令通过直接加 -f。如果只是想看哪些本地分支已经合并，也可以在主工作树执行 git branch --merged main，但它不能替代对路径和脏文件的检查。

用 remove 清理，不要先手动删目录

回到主工作树后，沿着“源代码管理 → 存储库 → 当前仓库”的上下文确认路径，再在集成终端执行：

# 删除已经确认干净的链接工作树及其 Git 管理记录
git worktree remove /work/app-review

# 立即重新列出，确认删除对象不是主工作树
git worktree list --verbose

Git 默认只允许移除干净的链接工作树，主工作树不能被 remove 删除。只有在你已经确认未提交内容可以永久丢弃时，才使用 git worktree remove --force /work/app-review；锁定的工作树需要先执行 git worktree unlock /work/app-review，并重新核对路径。

如果目录早已被文件管理器或脚本手动删除，Git 可能还保留一条失效的管理记录。这时先预览：

# 只预览缺失工作树的残留记录，不立即删除任何元数据
git worktree prune --dry-run --verbose

最后看一遍列表，确认主工作树仍在

成功清理后，列表中应保留主工作树和仍在工作的链接工作树，候选路径不再出现。若主工作树路径消失，立即停止后续清理，先检查当前目录与仓库状态；不要连续执行带 --force 的命令。

常见疑问

为什么 remove 提示工作树不干净？ 这是保护机制，先用候选路径执行 git status --short，确认修改、未跟踪文件或子模块是否需要保留；不要把拒绝当成故障。

prune 能替代 remove 吗？ 不能。remove 用于正常清理仍存在的链接工作树；prune 主要处理目录已经丢失后的过期管理记录，最好先用 --dry-run 预览。

最终检查可以固定成三件事：候选分支的合并关系返回 0、候选工作区没有未提交文件、再次 git worktree list --verbose 时第一行主工作树仍在。满足这三个条件，再把分支删除或保留交给团队的分支清理策略。