常见事故恢复路径(误 amend / 误 stash / 误删分支)
覆盖六类高频 Git 事故的只读定位与安全恢复。全部恢复动作遵守两条总纪律:先只读定位、后恢复(reflog / fsck / show 核实内容再动引用);恢复优先新建、不改写(新建分支或引用不动任何现态,天然可逆;reset / force 类操作必须用户明确指示)。
0. 第一现场:reflog 与 fsck
git reflog默认保留 90 天(gc.reflogExpire),不可达条目 30 天(gc.reflogExpireUnreachable)。事故后先不要跑git gc --prune=now——那会真的清掉待恢复对象。git branch -d/-D会同时删除该分支的 reflog;不能再依赖git reflog show <deleted-branch>。先查删除输出中的 tip、当前及其他 worktree 的 HEAD reflog、仍存在的引用与备份,必要时再用 fsck 找不可达对象。- 找无引用指向的悬空提交:
git fsck --no-reflogs --unreachable | grep commit;确认内容再用:git show <sha> --stat/git log --oneline <sha>。
1. 误 amend(改错内容 / 丢了原提交信息,且未 push)
原理:amend 创建新提交,旧提交是完整对象,只是失去引用——reflog 里就是 commit (amend) 的上一条。
# 1. 定位旧提交(amend 前的原 tip)
git reflog -5 # 找 "commit (amend)" 行的前一条
# 2. 核实旧提交内容确实是想要的
git show <old-tip> --stat
# 3a. 整体回到旧提交(保留工作区,amend 后的改动回到暂存区)
git reset --soft <old-tip>
# 3b. 只找回提交信息(保留 amend 后的树):从旧提交拷 message
git log -1 --format=%B <old-tip>红线:
- 已 push 的 amend = 历史重写,读取共同约束与历史撤回的具名授权边界;本技能 safe-push 不支持 force,不退回裸 push。
reset --soft在误 amend 的分支上是撤销 amend(新提交仍留在 reflog 可再找回),但执行前确认没有并行会话已基于 amend 后的提交工作。
2. 误 stash(pop 冲突以为丢了 / drop 错了)
关键事实(先读再动手,多数"丢 stash"是误判):
git stash pop有冲突时 stash 条目不会被删——冲突解决完、git status干净后它仍在git stash list,需要手动git stash drop。pop 冲突时工作区呈现「Updated upstream / Stashed changes」两段语义,那是冲突标记不是丢数据。git stash apply永远不删条目;不确定时用 apply,确认后再 drop。- untracked 文件(
stash -u)存在 stash 提交的第三个 parent(stash@{0}^3),找回时别只看第一个 parent。
误 drop / pop 后想反悔的恢复:
# 1. 找悬空的 stash 提交
git fsck --no-reflogs --unreachable | grep commit
# 或直接看候选内容(逐个确认,stash 提交有 2-3 个 parent)
git show --stat <sha>
# 2. 重新登记为 stash 条目(不动工作区)
git stash store -m "recovered stash" <sha>
git stash list # 确认回来了
git stash show -p 'stash@{0}' # 核内容再决定 apply3. 误删本地分支(branch -d / -D 后)
原理:删分支会同时删除引用与该分支的 reflog,提交对象可能仍在对象库;曾检出该分支的 worktree 的 HEAD reflog、其他引用或备份可能保存其 tip(§0)。没有引用或 reflog 保护的对象可能被 GC 回收,不能保证恢复。
# 1. 从删除命令输出的 SHA 或 HEAD reflog 定位候选 tip
git reflog show HEAD
# 多 worktree:在曾检出该分支的工作区查看其 HEAD reflog
git -C <worktree-path> reflog show HEAD
# 2. 核内容
git log --oneline <tip> -5
# 3. 新建引用恢复(不动任何现态,随时可再删)
git branch <deleted-branch> <tip>HEAD reflog 中没有候选时(例如分支从未检出),先核备份、其他引用与远端,再按 §0 fsck 找不可达提交,逐个 git show 核内容;确认 tip 后新建分支恢复。不要把 reflog 中最近一条不相关提交直接当作旧 tip。
预防(与 branch-lifecycle-and-cleanup.md 一致):删除前先跑 scripts/branch-audit.sh 只读盘点,核当前 tip、真实目标、实际采用与生命周期、材料/占用及具名删除授权;MERGED 与 patch-id 仅作线索,不单独判死,不凭 -D 强删。
4. 误删远端分支(push origin --delete 错了)
- 本地有同名分支或 reflog:先确认目标仓库/分支确属误删、核恢复的完整 tip 和授权,再按身份与推送核完整范围并用 safe-push 发表已验 OID;旧提交身份或 base 不满足门禁时保留候选,不能缩窄范围或退回裸 push。
- 本地也没有:GitHub 的 PR 页面可能提供 Restore branch;先核原 head OID、当前同名引用、具名恢复授权与完整历史的身份/隐私,符合条件才恢复并后验实际 ref/OID;fetch 取回更新远端跟踪引用,不改写当前检出。
- 无 PR 且无人有副本:提交仍可按 SHA 访问(GitHub dangling 对象),但引用恢复没有机械路径——如实报告,不臆测。
5. 误 reset --hard / checkout . / clean -f(丢弃工作区未提交内容)
checkout-index -a -f、read-tree -u或直接文件覆盖也按本节处理。先保全事故命令、原 HEAD/index、已知事故前状态和仍存在的正文,证据从临时目录复制到仓外持久位置。不要把“恢复索引”顺手扩成重写整个工作区。- 已提交的内容:按 §0 reflog 找回 tip,
git branch backup/<desc> <tip>新建引用恢复。 - 曾暂存但未提交的内容:
git add已把当时内容写入 blob,对象尚未被回收时可尝试git fsck --no-reflogs --unreachable找候选 blob,先用git cat-file -p <blob-oid>只读核内容,确认后导出到独立恢复目录。blob 本身不保存文件名/目录;只能找回曾写入对象库的字节,暂存后继续编辑的部分未必可恢复。 - 从未被 Git 收录的工作区内容或 untracked 文件:不能指望 Git 对象库恢复。可尝试 IDE 本地历史(JetBrains Local History / VS Code Timeline)、Time Machine、整目录 rsync 备份(见 history-rewrite-and-removal.md 的三层备份)。不因 fsck 找到某个 blob 就承诺全部内容已找回,也不因“未提交”就跳过对象库检查。
没有系统备份时继续查既有 worktree、固定发布载荷、采用前 original-files、逐文件哈希清单及会话产物。先把候选复制到仓外救援区,再区分“事故前哈希精确一致”“仅历史候选”“尚无依据”;不按最多副本或最新 mtime 直接覆盖。事故前的 D 代表原本删除,不是丢了该文件正文;类型变更要恢复实际目录/链接关系。恢复后 status 相同只证明路径状态,须另外逐文件校验实际内容,并核事故后新增仍完整。无法证实的最新字节仍报未确认。风险操作前的快照入口见主目录保护。
6. 误 commit 到错分支(落到并行会话的分支上)
按改动集成处理:不 git branch -f 强移并行会话正在检出的分支;先复用适合现场,必要时按稀疏合同从正确 base 创建窄范围候选,再采用已核改动并走身份/隐私发表门禁。保留原误落提交与来源映射,后续整理或丢弃另核归属与授权,不提前宣称 main 已采用。