疑难恢复与事故处理

开场:先分清“丢”的三种情况

事故场景千奇百怪,但落到 Git 层面只有三类。判断方法只有一句话:这个内容进过 Git 吗? 进过,大概率能救;没进过,别浪费时间。

情况

例子

还能救吗

提交还在,只是分支指针被移走

reset --hard、误删分支

能。reflog 直接找回

提交被新提交替换

amend、rebase

能。旧提交在对象库里,reflog 能找到

从来没进过 Git

工作区没 add 的改动被 restore 或 reset --hard 丢了

不能。Git 从没见过它

第三类要特别小心:没进过 Git 的内容,任何工具都救不回来。因为 Git 的对象库里根本没有它。 所以下面所有方法,前提都是“它至少进过暂存区或对象库”。

reflog:Git 的后悔药

reflog 是什么

要解决什么:知道自己刚才动了指针,但不知道动之前在哪。

每次 HEAD 或分支引用移动,Git 都会往 .git/logs/ 下记一笔。 这个日志就是 reflog(引用日志)。它记录的不是“提交历史”,而是“指针移动历史”。

git reflog
a1b2c3d (HEAD -> main) HEAD@{0}: reset: moving to HEAD~1
e5f6a7b HEAD@{1}: commit: feat: 添加搜索接口
d4e5f6a HEAD@{2}: commit: fix: 修复分页
c3d4e5f HEAD@{3}: commit: feat: 添加库存接口

每一行的结构:

部分

含义

a1b2c3d

这次移动后,指针指向的哈希

HEAD@{0}

第几次移动,0 是最近一次,数字越大越早

reset / commit

是什么操作导致的移动

moving to HEAD~1

操作的说明

分支也有自己的 reflog:

git reflog show main

找回误 reset 的提交

要解决什么:git reset --hard HEAD~1 把最新提交从分支上抹掉了。

git reset --hard HEAD~1
HEAD is now at d4e5f6a fix: 修复分页

别慌。先看 reflog,找到 reset 之前那一行:

git reflog
a1b2c3d (HEAD -> main) HEAD@{0}: reset: moving to HEAD~1
e5f6a7b HEAD@{1}: commit: feat: 添加搜索接口

被抹掉的提交是 e5f6a7b。两种救法:

直接 reset 回去:

git reset --hard e5f6a7b

更稳妥:先建分支看看,确认内容对再决定怎么合回 main。

git switch -c rescue e5f6a7b
git log --oneline -1
e5f6a7b feat: 添加搜索接口

先建分支再确认,比直接 reset --hard 安全

reset --hard 会再次覆盖当前状态。如果记错了哈希,可能把另一个东西也弄丢。 先 switch -c 到一个新分支,把旧提交接住,看清楚内容,再决定合并还是 reset。

找回误删的分支

要解决什么:git branch -D 强制删除了分支,提交还在,但没有名字指着它了。

git branch -D feature-login
Deleted branch feature-login (was c3d4e5f).

注意输出里 (was c3d4e5f),这就是被删分支最后指向的哈希。 有它就够,直接重建:

git branch feature-login c3d4e5f

如果当时没记住,用 reflog 找:

git reflog
# 找 "checkout: moving from feature-login to main" 或最后一次在 feature-login 上的提交
git branch feature-login <那个哈希>

找回 amend 之前的提交

要解决什么:git commit --amend 替换了旧提交,现在想要旧的那一版。

amend 本质是造一条新提交,旧提交还在对象库里,只是没引用指向它。reflog 里有记录:

git reflog
a1b2c3d (HEAD -> main) HEAD@{0}: commit (amend): 新信息
e5f6a7b HEAD@{1}: commit: 旧信息

HEAD@{1} 就是 amend 之前的提交。想回去:

git reset --hard e5f6a7b

reflog 的边界

这一条必须记住:reflog 是本地的,不会随 push 或 fetch 同步。

  • 你本地 reset --hard 丢了提交 → reflog 能救;

  • 你 push --force 把远程别人的提交盖掉了 → 别人的 reflog 救不了远程,只能靠别人本地还留着原物;

  • 你换一台机器 clone → 新机器上没有你之前的 reflog。

所以 --force 的代价从来不由敲它的人承担。改写远程历史之前,先想清楚谁可能已经拉过。

reflog 会过期。Git 默认保留:可达的 reflog 90 天,不可达的 30 天。手动清理:

git reflog expire --expire=now --all
git gc --prune=now

这是危险操作,会把没有引用的提交真正删掉。日常不要碰。

fsck --lost-found:最后手段

要解决什么:reflog 也被清了,或者不知道是哪个操作弄丢的。

它会扫描对象库,找出所有“没有引用指向”的对象:

git fsck --lost-found
dangling commit a1b2c3d...
dangling blob e5f6a7b...

dangling 就是“悬空”:对象还在,但没有分支、标签、HEAD 指向它。逐个看:

git show a1b2c3d

找到需要的,建分支接上:

git branch rescue a1b2c3d

fsck 是最后手段,因为它不告诉你“这个提交是什么时候丢的、为什么丢的”,只告诉你“有这些没引用的对象”。 先试 reflog,reflog 不行再 fsck。

误提交到 main:两种处理方式

要解决什么:本来该开分支的改动,直接提交到 main 了。处理方式取决于推没推。

情况一:还没推送

本地 main 上多了一条不该有的提交,远程还没有。用 reset 把提交撤掉,改动留在暂存区:

git reset --soft HEAD~1 git status -s
M app.js

然后切到正确的分支,重新提交:

git switch -c feature-x
git commit -m "feat: 正确的提交信息"

main 回到干净状态,改动挪到了 feature-x 上。 如果这条提交混了别的东西想重新挑,用 --mixed,改动退回工作区,重新 add。

情况二:已经推送

不要 reset 后强推共享分支。别人可能已经 pull 了这条提交,你一强推,他们的历史就和你对不上了。

正确做法是 revert:

git revert <那条提交的哈希>
[main d4e5f6a] Revert "错误的提交信息"

这会生成一条新提交,内容是“反向应用那条提交的改动”。历史没有被改写,只是多了一条“撤销”记录。然后正常 push:

git push

什么时候可以用 force-with-lease

只有同时满足这三个条件:

  • 这是你自己的分支,不是共享分支;

  • 你确认没有别人基于它工作;

  • 你刚 fetch 过,知道远程当前状态。

才可以:

git push --force-with-lease

main、develop、release 分支,永远不满足这三个条件。共享分支只用 revert。

一张表记住:

场景

命令

是否改写历史

未推送,本地 main 多提交

reset --soft HEAD~1

是(只改本地)

已推送,共享分支

revert <哈希> + push

否

已推送,自己的特性分支,确认无人使用

reset + push --force-with-lease

是

revert 的几个细节

revert 多个提交

git revert c3d4e5f d4e5f6a

按顺序反向应用。顺序会影响结果:如果两条提交有依赖,可能需要调整顺序。

revert 一个范围

git revert c3d4e5f..e5f6a7b

反向应用这个范围内的提交。默认从新到旧反向应用,因为要保证依赖关系。 注意 a..b 不含 a,要包含起点写 a~1..b。

revert 一个合并提交

合并提交有两个父提交,Git 不知道你要撤销哪一边的改动,必须用 -m 指定保留哪一边:

git revert -m 1 <合并提交哈希>

-m 1 表示“保留第一个父提交那一侧,撤销第二个父提交带进来的改动”。 通常第一个父提交是你合并时所在的分支(main),第二个是被合并进来的分支。

revert 合并提交有坑:以后想再合并那个分支,Git 会认为已经合并过了

revert 合并提交后,被撤销的那条分支的改动在历史上被标为“已处理”。之后想再合并同一个分支、带入新改动时, Git 可能不会重新带入。需要再 revert 一次那个 revert 提交,恢复合并关系。这是高级场景,遇到再查。

revert 冲突

revert 也可能冲突,处理方式和 merge 一样:

# 改文件解决冲突
git add <文件>
git revert --continue # 或者放弃
git revert --abort

冲突解错了怎么回退

要解决什么:解冲突解到一半发现方向错了,或者已经 commit 了才意识到解错。不同阶段,逃生门不同。

阶段

逃生门

merge 冲突解到一半

git merge --abort

merge 已 commit,还没推送

git reset --hard ORIG_HEAD

merge 已 commit,已推送

git revert -m 1 <合并提交>

rebase 冲突解到一半

git rebase --abort

cherry-pick 冲突解到一半

git cherry-pick --abort

ORIG_HEAD 是什么

Git 在危险操作(merge、rebase、reset)开始前,会自动把当时的 HEAD 记到 ORIG_HEAD 里。 它指向“操作开始前的 HEAD”。查看它指向哪:

git rev-parse --short ORIG_HEAD
git log --oneline -1 ORIG_HEAD

git reset --hard ORIG_HEAD 的意思是“回到那次危险操作开始前”。

一个小习惯

解冲突前,先记一下当前位置,或者干脆开个临时分支:

git rev-parse HEAD
# 或
git branch before-merge

出问题了有明确回退点,比依赖 ORIG_HEAD 更安心,因为 ORIG_HEAD 会被后续操作覆盖。

rerere:自动复用冲突解决

要解决什么:同样的冲突反复出现,每次都要手动解一遍。

rerere 是 “reuse recorded resolution” 的缩写。开启后,Git 会记录你每次怎么解冲突,下次遇到同样的冲突自动套用。

git config --global rerere.enabled true

适用场景:

  • rebase 一个分支,解了一堆冲突,结果 --abort 了想重来。再 rebase 时,rerere 自动把之前的解法套上;

  • 长期分支反复合并同一个上游,同样的冲突反复出现。

查看记录和手动忘掉某条:

git rerere status
git rerere diff
git rerere forget <文件名>

rerere 只认“文本层面完全相同的冲突块”,不是万能的,但能省掉大量重复劳动,尤其是 rebase 大分支时。

敏感信息清理

要解决什么:密码、token、私钥被提交进仓库,而且推送了。这是最严重的一类事故。

第一步:止损,不是清历史

第一步不是清 Git 历史,是让泄露的凭证失效:

  • 改密码;

  • 吊销 token / API key;

  • 换 SSH key。

因为一旦推送,即使你马上删掉,历史里还在,别人可能已经拉走了。清历史是第二步,止损是第一步。

为什么 git rm 不够

git rm secret.txt
git commit -m "remove secret"
git push

这只删掉了“当前版本”里的文件。历史提交里还有,任何人 git log -p 都能看到。 必须改写历史,把文件从所有历史提交里抹掉。

用 git filter-repo

git filter-branch 是老的官方工具,慢且容易出错。现在推荐 git filter-repo,需要单独安装。

删除某个文件的所有历史:

git filter-repo --path secret.txt --invert-paths

把某个字符串在所有历史中替换:

git filter-repo --replace-text replacements.txt

replacements.txt 里写:

旧密码==>***REMOVED***

清理后的必须步骤

1. 强推所有分支和标签:

git push --force --all
git push --force --tags

2. 通知所有协作者重新克隆。他们的本地仓库还有旧历史,直接 pull 会把旧对象带回来。

3. 在平台上清理缓存。GitHub / GitLab 可能还保留着旧的 commit 页面、PR 引用、fork 副本。 有些平台需要联系支持才能彻底清除。

4. 假设它已经泄露了。即使清理完,也要按“凭证已泄露”处理,该换的都换掉。

预防优先

清理历史代价很大。最好的办法是第一次就别提交:

  • .gitignore 里提前写好 *.env、*.pem、config.local;

  • 用 pre-commit 钩子扫描密钥(第九讲会讲 hooks);

  • 代码审查时留意配置文件。