Git worktree 删除分支前如何确认工作树状态

在 Git 中，删除分支前不能只看分支名。一个分支可能仍被某个 linked worktree 检出，目标目录里也可能藏着未提交文件。稳妥做法是先列出 worktree，再进入目标路径检查状态，确认干净后移除 worktree，最后删除分支。

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

先用 git worktree list --porcelain 找到分支对应的工作树，再用 git -C 目标路径 status --short --branch 检查改动；只有状态干净时才执行 git worktree remove，分支删除优先使用不带强制参数的 git branch --delete。

步骤一：打开仓库并列出全部 worktree

在编辑器中选择“文件 > 打开文件夹”，打开主仓库；再选择“终端 > 新建终端”。先确认终端位于仓库内，然后执行下面的命令。这里使用 porcelain 格式，是为了让每个工作树的路径、提交和分支字段更容易逐项核对。

# 查看当前仓库的根目录，避免在错误项目中操作
git rev-parse --show-toplevel

# 按稳定的字段格式列出主工作树和 linked worktree
git worktree list --porcelain

输出中第一条通常是主工作树，后续记录以 worktree 开头。看到 branch refs/heads/feature-login 后，记下它前一行的路径。若记录带有 locked 或 prunable，先不要删除，分别处理锁定原因或失联目录。

步骤二：检查目标工作树的提交和未提交文件

回到终端，使用目标路径作为 -C 参数。这样不用切换当前目录，也不会误把主工作树的状态当成目标状态。

# 将路径替换为步骤一记录的 linked worktree 路径
git -C ../feature-login status --short --branch

# 需要了解具体改动时，再查看已跟踪文件的差异
git -C ../feature-login diff --stat

# 单独列出未跟踪文件，避免漏掉未加入版本控制的内容
git -C ../feature-login ls-files --others --exclude-standard

只有第一行分支信息、后面没有文件标记时，才算适合继续。M 表示修改，D 表示删除，?? 表示未跟踪文件；这些内容应先提交、转移或明确备份。不要因为 git diff --stat 没有输出，就忽略最后一条未跟踪文件检查。

步骤三：移除干净的 linked worktree

确认目标工作树没有需要保留的内容后，回到主工作树执行“终端 > 新建终端”或复用当前终端，运行：

# 从主工作树移除已经确认干净的 linked worktree
git worktree remove ../feature-login

# 如果列表仍显示失联记录，先预览可清理的元数据
git worktree prune --dry-run

Git 默认会拒绝删除不干净的工作树，这是保护措施，不是故障。遇到 locked 时，先用 git worktree list --verbose 读取锁定原因；确认确实可以解除后执行 git worktree unlock ../feature-login，再重新检查状态。除非已经单独保存并确认可以丢弃改动，不要用 git worktree remove -f。

步骤四：复查占用关系后删除分支

删除目录后，重新列出 worktree，确认目标分支已不再被任何工作树检出：

# 复查所有工作树，确认 feature-login 不再出现
git worktree list --porcelain

# 查看分支是否已合并以及它当前指向的提交
git branch --list --verbose feature-login

# 优先使用安全删除：未合并时 Git 会拒绝并提示原因
git branch --delete feature-login

git branch --delete 失败时，不要立即改成 -D。先检查分支是否还有未合并提交，必要时用 git log main..feature-login --oneline 查看差异；只有明确放弃这些提交时，才由负责人决定是否强制删除。

常见问题：删除前最容易漏掉的状态

为什么 worktree remove 提示不干净？

目标目录存在已修改的跟踪文件或未跟踪文件。用 git -C 目标路径 status --short 重新确认，并先提交、备份或清理，再重试。

目录手动删除后还显示在列表中怎么办？

先执行 git worktree list --verbose 判断是否为失联记录，再用 git worktree prune --dry-run 预览，确认无误后执行不带 --dry-run 的清理。

为什么分支删不掉？

它可能仍被其他 worktree 使用，或包含尚未合并的提交。分别复查 worktree 列表和分支差异，确认两者都没有风险后再处理。

最终检查可以压缩成四项：目标路径正确、状态没有文件标记、worktree 列表已解除占用、分支删除没有使用未经确认的强制参数。按这个顺序操作，既能清理临时工作树，也能保住尚未提交或尚未合并的内容。