git checkout -d 后分支还在，并出现 detached HEAD

想删除本地分支，执行 git checkout -d quick-test 后，Git 却显示 HEAD is now at ...。再次列出分支，会看到类似状态：

* (HEAD detached at refs/heads/quick-test)
  main
  quick-test

这条命令没有删除分支。在 git checkout 中，-d 是 --detach，表示让 HEAD 直接指向一个提交；在 git branch 中，-d 才是 --delete。选项的含义由子命令决定，不能只比较短选项和长选项的拼写。

以下处理已有提交的普通 Git 工作仓库。quick-test、main 和备份分支名都是示例，请替换为实际名称。分离 HEAD 本身不是仓库损坏，先确认有没有需要保留的新工作，再执行删除。

先看是否只切换了状态

在仓库目录检查：

git status --short --branch
git branch --list quick-test
git rev-parse HEAD
git rev-parse refs/heads/quick-test

第一条查看当前状态及未提交文件，第二条确认本地分支是否还在。后两条分别打印当前提交和目标分支指向的提交；若刚刚执行了那次 checkout -d，且之后没有其他操作，它们应相同。

如果两个提交已经不同，不能直接当作删除失败后的残留。你可能在 detached HEAD 状态又提交了代码，或者分支被其他操作更新。先保留当前提交的位置，再决定清理哪个名字。分支已经不存在时，最后一条会报引用无法解析，应转去核对已有备份和本地 reflog，不能据此强制重建分支。

已经继续开发，先给当前提交一个分支名

在 detached HEAD 状态提交时，HEAD 会前进，原来的 quick-test 不会自动跟着前进。若不确定有没有新提交，保守做法是在离开当前提交前创建一个尚不存在的分支：

git switch -c saved-detached-work

本机没有 switch 子命令时，可以使用下面的等价写法，两者只选一个：

git checkout -b saved-detached-work

新分支指向当前提交，并成为当前分支。不要把小写创建选项改成大写强制选项，以免重置已有的同名分支。

这一步保存的是提交的引用，不会自动提交工作目录里的修改，也不包含未跟踪、忽略文件的独立备份。需要保留的文件应先妥善保存；如果状态显示仍在合并、变基或有未解决冲突，先处理那项操作，不要穿插分支清理。

如果已经离开分离状态，可以只读查看本地记录：

git reflog show HEAD

从记录中确认需要保留的提交，再以它创建新分支。不要把某条固定序号当成通用答案：每次操作都会改变 reflog 序号，记录也会过期，它不能替代备份。

确认目标历史后再删除本地分支

已经保存需要的工作，且确认 main 是要返回的现有本地分支时，切换过去：

git switch main

旧版 Git 可用 git checkout main。若 Git 提示切换会覆盖修改，先保存修改，不要加 --force 或执行硬重置来绕过提示。

删除前记录目标分支的完整提交 ID，并查看它相对保留分支的提交：

git rev-parse refs/heads/quick-test
git log --oneline main..quick-test

第二条列出 quick-test 能到达、而 main 不能到达的提交。如果有输出，先审查这些工作是否需要合并或保留，不要仅因分支名字叫“测试”就认定可删。没有输出表示该范围内没有独有提交；如果命令报错，则检查引用是否存在，不能把错误当成空结果。

若确实要删除这个本地分支，可以先留一个不同名称的临时备份引用，再执行小写 -d：

git branch saved-quick-test quick-test
git branch -d quick-test

saved-quick-test 必须尚不存在；第一条失败时停下核对，不要直接继续第二条。备份分支不会自动合并代码，也不会推送到服务器，只是保留一个可找回提交的本地名字。

git branch --delete quick-test 与这里的小写 -d 含义相同，二选一即可。它检查目标分支是否已完全合入其配置的上游；没有上游时，才以当前 HEAD 为判断对象。因此，删除成功本身不保证目标历史已经合入你以为的 main，前面的显式比较仍有意义。

如果提示尚未完全合并，应停下检查。大写 -D 会绕过这项保护，不是修正本次子命令错误所必需的操作。若提示分支正在当前目录或其他 worktree 使用，先核对那个工作目录的状态，不要删除 Git 内部管理文件。

列表里还有一个看起来像 -d 的分支

有时复制命令时混入了长横线，列表中实际出现的是 –d：第一个字符是 Unicode en dash，不是命令选项使用的 ASCII 连字符 -。

二者外观接近，但属于不同字符。这样的分支名不能证明 Git 把正常的 -d 选项执行错了。先检查实际名称和它指向的提交，确认没有需要保留的历史后再清理；不要照着外观把相似名字逐个强制删除。重新输入命令时使用普通半角连字符。

验证删除结果与恢复路径

完成后检查：

git status --short --branch
git branch --list quick-test
git branch --list saved-quick-test

当前状态应显示预期的工作分支；quick-test 不再列出，备份引用仍在。需要保留分离状态下的新提交时，还应确认 saved-detached-work 保留着那段历史。这些都是本地引用检查，不代表服务器上的同名分支已经删除。

如果发现删错了名称，且备份引用仍然正确、原名尚未被重新使用，可以恢复：

git branch quick-test saved-quick-test

它恢复分支指向的提交，不会自动切换工作目录，也不会还原原分支的全部配置和 reflog。新分支建立后再按实际需要设置上游。等工作去向确认清楚后再清理备份引用，不需要为退出 detached HEAD 删除任何提交。