适用范围与准备

适用于切到某个标签或提交后,Git 提示 detached HEAD,随后做了本地提交,却发现原分支没有它。先停在当前目录保存状态与提交编号。本篇不推送、不重写历史;多人共用工作区应先确认没有另一项任务正在操作。

先区分原因

分支名是指向提交的可移动引用,detached HEAD 则直接指向某个提交。在这种状态下可以创建提交,但它不会自动推进原分支。切回原分支后看不到新提交,并不等于网络同步失败,也不应先拉取或强推。

按顺序操作

  1. 运行下方只读命令,记录 git status 的分离状态、HEAD 的完整提交号以及最近提交。git branch --show-current 在分离状态下可能没有分支名;不要把空输出当成没有提交或命令运行失败。
  2. 如果需要保护的新提交仍是当前 HEAD,选择一个尚未使用、符合团队约定的分支名,运行 git switch -c rescue-local-work。这里的名称只是示例;使用小写 -c,避免用会重置已有分支的 -C。
  3. 新分支应指向刚记录的同一个提交。未提交文件也要单独看 git status;创建分支不会替你提交这些修改,不能以有了分支名为由删除旧工作文件。
  4. 若已经离开那个提交,先查看 git reflog,结合操作时间与提交说明找候选,再用 git show 查看实际内容。确认准确提交后可以新建保护分支指向它;不要猜一个哈希就 reset,也不要在找回前运行清理历史的命令。
  5. 保护完成后,再按项目审查流程决定是否把提交合并或挑选到目标分支。标签所指版本可能与当前开发分支不同,直接强推既不能解释差异,也可能影响其他人的历史。
目标仓库内只读记录;不会切分支或联网
git status --short --branch
git branch --show-current
git rev-parse HEAD
git log -3 --oneline
只有当前 HEAD 就是待保护提交,且该分支名尚未使用时才运行
git switch -c rescue-local-work

怎样确认有效

创建保护分支前后 HEAD 提交号应一致,git show 能看到预期修改,未提交文件的状态也符合原记录。这只是本地保护,不是远端备份。已经过期或被清理的 reflog 不保证可找回所有历史,因此发现问题时应尽早记录并停止破坏性操作。

无效时恢复与下一步

如果选错了候选,先保留已有保护分支,回看 reflog 和实际差异,不急着删除引用。若只想阅读旧版本,分离状态本身可以正常使用;准备继续开发时再建新分支。涉及冲突和团队目标分支时,交由正常代码审查流程处理。