疑难恢复与事故处理
开场:先分清“丢”的三种情况
事故场景千奇百怪,但落到 Git 层面只有三类。判断方法只有一句话:这个内容进过 Git 吗? 进过,大概率能救;没进过,别浪费时间。
情况 | 例子 | 还能救吗 |
|---|---|---|
提交还在,只是分支指针被移走 |
| 能。 |
提交被新提交替换 |
| 能。旧提交在对象库里, |
从来没进过 Git | 工作区没 | 不能。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: 添加库存接口每一行的结构:
部分 | 含义 |
|---|---|
| 这次移动后,指针指向的哈希 |
| 第几次移动, |
| 是什么操作导致的移动 |
| 操作的说明 |
分支也有自己的 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 e5f6a7breflog 的边界
这一条必须记住: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 a1b2c3dfsck 是最后手段,因为它不告诉你“这个提交是什么时候丢的、为什么丢的”,只告诉你“有这些没引用的对象”。 先试 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-leasemain、develop、release 分支,永远不满足这三个条件。共享分支只用 revert。
一张表记住:
场景 | 命令 | 是否改写历史 |
|---|---|---|
未推送,本地 |
| 是(只改本地) |
已推送,共享分支 |
| 否 |
已推送,自己的特性分支,确认无人使用 |
| 是 |
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 冲突解到一半 |
|
merge 已 commit,还没推送 |
|
merge 已 commit,已推送 |
|
rebase 冲突解到一半 |
|
cherry-pick 冲突解到一半 |
|
ORIG_HEAD 是什么
Git 在危险操作(merge、rebase、reset)开始前,会自动把当时的 HEAD 记到 ORIG_HEAD 里。 它指向“操作开始前的 HEAD”。查看它指向哪:
git rev-parse --short ORIG_HEAD
git log --oneline -1 ORIG_HEADgit 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.txtreplacements.txt 里写:
旧密码==>***REMOVED***清理后的必须步骤
1. 强推所有分支和标签:
git push --force --all
git push --force --tags2. 通知所有协作者重新克隆。他们的本地仓库还有旧历史,直接 pull 会把旧对象带回来。
3. 在平台上清理缓存。GitHub / GitLab 可能还保留着旧的 commit 页面、PR 引用、fork 副本。 有些平台需要联系支持才能彻底清除。
4. 假设它已经泄露了。即使清理完,也要按“凭证已泄露”处理,该换的都换掉。
预防优先
清理历史代价很大。最好的办法是第一次就别提交:
.gitignore里提前写好*.env、*.pem、config.local;用 pre-commit 钩子扫描密钥(第九讲会讲 hooks);
代码审查时留意配置文件。