detached HEAD恢复：先建分支保住提交，再切回日常开发

查看旧版本时进入分离头指针状态并不代表仓库损坏。本文区分只读查看与已经产生新提交的处理办法。

Git 提示 detached HEAD，说明当前检出的是某个提交，而不是正常附着在分支上。查看历史版本时这很常见，真正需要注意的是在这里新做的工作是否已有分支引用。

只查看，没有修改

先运行 git status，确认没有未保存的更改。若只是看旧代码，可以切回原来的开发分支。不要为消除提示而执行硬重置；状态提示本身不是故障，也不需要清空仓库。

已经改代码或提交

仍停留在该状态时，使用 git switch -c 加一个明确的新分支名，把当前提交保留下来。然后检查日志和工作区，确认需要的提交已经归入分支。未提交修改也要单独检查，分支存在不等于文件已经提交。

切走后才发现遗漏

可以借助 reflog 寻找最近的位置，先核对目标提交内容，再为它建立恢复分支。不要只凭时间猜编号，更不要批量清理引用。找到内容后，用正常合并或选择提交的方式移入开发分支。

验收标准是新分支可见、提交可追溯、修改内容完整，而不是终端不再显示警告。发布脚本若故意检出固定提交，可以保留这种模式，但应禁止在临时部署目录里继续日常开发。

参考资料

资料核对：2026年10月27日。本文为文档综合与操作建议，未宣称完成本站实测。

Git switch 手册

Git cherry-pick 手册