适用范围与准备
适用于切到某个标签或提交后,Git 提示 detached HEAD,随后做了本地提交,却发现原分支没有它。先停在当前目录保存状态与提交编号。本篇不推送、不重写历史;多人共用工作区应先确认没有另一项任务正在操作。
先区分原因
分支名是指向提交的可移动引用,detached HEAD 则直接指向某个提交。在这种状态下可以创建提交,但它不会自动推进原分支。切回原分支后看不到新提交,并不等于网络同步失败,也不应先拉取或强推。
按顺序操作
- 运行下方只读命令,记录 git status 的分离状态、HEAD 的完整提交号以及最近提交。git branch --show-current 在分离状态下可能没有分支名;不要把空输出当成没有提交或命令运行失败。
- 如果需要保护的新提交仍是当前 HEAD,选择一个尚未使用、符合团队约定的分支名,运行 git switch -c rescue-local-work。这里的名称只是示例;使用小写 -c,避免用会重置已有分支的 -C。
- 新分支应指向刚记录的同一个提交。未提交文件也要单独看 git status;创建分支不会替你提交这些修改,不能以有了分支名为由删除旧工作文件。
- 若已经离开那个提交,先查看 git reflog,结合操作时间与提交说明找候选,再用 git show 查看实际内容。确认准确提交后可以新建保护分支指向它;不要猜一个哈希就 reset,也不要在找回前运行清理历史的命令。
- 保护完成后,再按项目审查流程决定是否把提交合并或挑选到目标分支。标签所指版本可能与当前开发分支不同,直接强推既不能解释差异,也可能影响其他人的历史。
git status --short --branch
git branch --show-current
git rev-parse HEAD
git log -3 --onelinegit switch -c rescue-local-work怎样确认有效
创建保护分支前后 HEAD 提交号应一致,git show 能看到预期修改,未提交文件的状态也符合原记录。这只是本地保护,不是远端备份。已经过期或被清理的 reflog 不保证可找回所有历史,因此发现问题时应尽早记录并停止破坏性操作。
无效时恢复与下一步
如果选错了候选,先保留已有保护分支,回看 reflog 和实际差异,不急着删除引用。若只想阅读旧版本,分离状态本身可以正常使用;准备继续开发时再建新分支。涉及冲突和团队目标分支时,交由正常代码审查流程处理。