个人站点
Git

主线 · 第 7 / 8 篇

· 约 7 分钟

丢了的提交还能找回来吗:reflog,以及对象什么时候才真的被删

HEAD 和每个分支改指向时,Git 都在本地记一笔,这就是 reflog。reset 拿掉的、删分支丢掉的提交,大多能从这里找回。它只在本地,有保留期限;提交真正被删,要等 reflog 过期、再被垃圾回收清掉。

本文目录 6 节
  1. reflog 记的是引用指向的变化
  2. 弄丢两个提交
  3. 找回来,就是重新给它一个名字
  4. reflog 只在本地
  5. 对象什么时候才真的被删
  6. 参考资料

前几篇反复出现一句话:名字没了,对象还在。删分支、reset 拿掉提交、游离 HEAD 下的提交被丢下、变基和 amend 换下来的旧提交,都是这样。接下来的疑问自然是:哈希没记下来,怎么找回?它们会一直留着吗?什么时候才真的没了?

先说明一个词。引用日志(reflog)记录的是本地仓库里,HEAD 和各个分支在什么时候改成了指向什么。它记的是引用的变化,不是文件的变化。

reflog 记的是引用指向的变化

git-reflog 文档的定义是:引用日志记录本地仓库中分支和其他引用的末端何时被更新。Pro Git 讲数据恢复时说得更直白:工作时,Git 会默默记下每一次 HEAD 改变时它的值,每次提交或切换分支,引用日志都会更新。

接着用前几篇的演示仓库。在 second 之后又提交一个 third(2565439),再拉出 feature 分支提交一次(2a0b695),然后切回 main。这时 .git/logs 下有三个文件:HEAD、refs/heads/main、refs/heads/feature,HEAD 和每个分支各一份日志。

弄丢两个提交

现在一次弄丢两样东西:在 main 上 git reset --hard HEAD~,third 从 main 上被拿掉;再 git branch -D feature,feature 上的提交也没有名字了。git log --all 只剩下 second 和 first。

$ git reflog
86c0fab HEAD@{0}: reset: moving to HEAD~
2565439 HEAD@{1}: checkout: moving from feature to main
2a0b695 HEAD@{2}: commit: feature work
2565439 HEAD@{3}: checkout: moving from main to feature
2565439 HEAD@{4}: commit: third
86c0fab HEAD@{5}: commit: second
b6c8214 HEAD@{6}: commit (initial): first

最新的在最上面。每一行是 HEAD 的一次变化:变化之后指向哪个提交,这是倒数第几次,以及由什么操作引起。丢掉的两个提交都在里面:2565439 是 third,2a0b695 是 feature work。

HEAD@{2} 这种写法可以直接当作提交名用。gitrevisions 文档的解释是:<引用>@{n} 表示这个引用往前数第 n 次的值。git reflog show main 只看 main 自己的日志,main@{1} 是 main 上一次的指向,也就是 reset 之前的 third。

名字没了,日志还记着旧值 reset 和删除 feature 后,main 指向 second,即 86c0fab。third 的 2565439 和 feature work 的 2a0b695 仍在对象库中,父子关系不变。HEAD 日志的第 1、2 个旧值分别记录着这两个提交,可以据此找回哈希。 当前分支HEAD 日志里记着的旧值 main HEAD@{1}HEAD@{2} 86c0fabsecond 2565439third 2a0b695feature work main 只到这里没有分支指向,但提交尚未被清理 feature 自己的日志已经删除;这里用的是 HEAD 的日志。
横向实线指向父提交。竖向点线表示从日志查出旧值,不是当前分支的指向;日志有保留期限,不能当作永久备份。

找回来,就是重新给它一个名字

找回的办法和第三篇处理游离提交一样:给它补一个引用。下面第一条命令只建分支,第二条会让 main 回到原位置,并用 reset --hard 覆盖工作区。演示的工作区是干净的;有未提交的改动时,先只建一个恢复分支,再检查内容。

$ git branch feature HEAD@{2}
$ git reset --hard main@{1}
HEAD is now at 2565439 third
$ git log --oneline --all
2a0b695 feature work
2565439 third
86c0fab second
b6c8214 first

feature 分支建回来了,main 也回到了 reset 之前。第六篇说,reset、删分支和 amend 换下的提交通常还能找回,靠的就是这些记录;未提交的暂存区和工作区内容不在这个保证范围内。oh-my-git 讲 reflog 的那一关也是同一个场景:之前看过某个旧提交,午饭回来想不起是哪个了,reflog 记着 HEAD 去过的每个地方。

有一个细节:删分支时,这个分支自己的日志也一起删了,.git/logs/refs/heads/feature 已经不存在。能找回 feature 上的提交,是因为 HEAD 的日志还记着当时在 feature 上提交过。

reflog 只在本地

gitrevisions 文档特别说明,@{...} 查的是本地引用在某个时间的状态。reflog 不会随推送上传,也不会被克隆带走。把演示仓库克隆一份,新克隆的 reflog 只有一条,就是克隆本身。

由此能推出 reflog 管不到的范围。没有提交过的改动,从来没有进过任何引用,reflog 里没有它,第六篇说的 reset --hard 覆盖掉的未提交内容找不回,原因就在这里。别人仓库里发生的事,自己的 reflog 也不知道。第五篇里 alice 的提交被 bob 强推覆盖,bob 本地从没拿到过那个提交,他的 reflog 里也就没有;能找回它的,是 alice 自己的仓库,或者服务器上还没被清理的对象。

对象什么时候才真的被删

没有分支再能走到的对象不会马上消失,还要看 reflog 的保护和垃圾回收期限。

第一道是 reflog 本身会过期。按 git-gc 文档,gc.reflogExpire 默认 90 天;gc.reflogExpireUnreachable 默认 30 天,针对从该引用当前指向已经走不到的条目。amend、变基换下的旧提交,以及演示里尚未找回的 third,都属于后一类。

第二道是垃圾回收。对象不再受其他引用或 reflog 保护,并且足够旧,才可能被清理。git gc 对松散对象(还没打包、单独存成文件的对象)的默认清理期限是两周,可用 gc.pruneExpire 调整。这里按对象的时间判断,不是从 reflog 过期那天重新算两周。Git 也可能自动运行维护,不一定要人手动执行 gc。

演示里把 feature 再删一次,用 git fsck --unreachable --no-reflogs 看。不算 reflog 的话,有一个不可达的提交,也就是从任何引用出发都走不到它,还有它带来的树和数据对象。

先直接 git gc,提交还在,reflog 仍保护它。再把 reflog 立即过期,并执行 git gc --prune=now,取消对象的时间保护。最后用 git cat-file -t 2a0b695 检查,报 could not get object info:这个提交真的没了。这是在可丢弃的演示仓库里验证清理,不是恢复步骤。

默认设置通常会留下恢复机会,但不是“30 到 90 天再加两周”的保管承诺。记录已有多旧、分支日志是否被删、清理配置是否被改过,都会影响还能不能找回。git reflog expire 和 git gc --prune=now 会主动缩短保护时间。reflog 也没有了时,Pro Git 还介绍了 git fsck --full:仍留在对象库里的悬空提交可能显示为 dangling commit,已经被清理的则无从恢复。

审 AI 的 Git 操作时,它说某个提交“已经没了”,可以先问一句有没有查过 git reflog。它要做恢复,让它先说清是从 reflog 的哪一条恢复、恢复到哪个分支。看到 reflog expire、gc --prune=now、或者删除 .git 下的文件,就要停下来确认,这些操作会让本来能找回的提交变得找不回。

参考资料

  • Pro Git:维护与数据恢复:用 reflog 找回硬重置和删分支丢掉的提交,reflog 存在 .git/logs,git fsck --full 找悬空提交。
  • git-reflog:引用日志的定义,HEAD@{2} 的含义,过期选项的默认值。
  • gitrevisions:<引用>@{n} 是第 n 次之前的值,查的是本地引用的状态。
  • git-gc:gc.reflogExpire 90 天、gc.reflogExpireUnreachable 30 天、默认清理两周前的松散对象,常用命令会自动触发 gc。
  • oh-my-git:shit-happens 一组里的 reflog 关卡。

本文涉及的知识点

8 个

名称打开知识图谱中的对应条目;「另见」只计已发布文章。