版本控制与协作 / 系统课时

使用 reflog 找回误删提交

使用 reflog 找回误删提交

学习目标

完成本课后,你将能够:

  • 说明 reflog 记录引用移动历史
  • 定位 reset 或删除分支前的提交
  • 通过新分支恢复不可达提交

问题背景或应用场景

误执行 reset、删除分支或在分离 HEAD 中提交后,提交可能从普通 git log 消失,但对象通常不会立刻被垃圾回收。reflog 记录本地引用曾经指向的位置,为恢复提供短期线索。

核心原理

reflog 是本地仓库日志,常见条目包括提交、切换、合并、变基和重置造成的引用移动。HEAD@{1} 表示 HEAD 的上一个记录位置,但序号会随新操作变化,因此恢复时最好复制具体提交哈希。

reflog 不会同步到远程,也不是永久备份。不可达对象可能在日志过期和垃圾回收后被清理。找到目标后,应立即创建分支或标签,使其重新成为可达对象。

reflog 恢复时间线

基础用法

先执行 git reflog --date=local,根据操作说明和时间定位提交。使用 git show <哈希> 核对内容,再执行 git branch recovered <哈希>。确认恢复分支无误后再合并或选择提交。

完整可运行示例

以下命令使用 Bash 语法,并在独立测试目录中执行。示例只使用本地仓库或本地裸仓库模拟远程服务,不依赖互联网;提交哈希、绝对路径等动态值不作为固定输出。

bash
rm -rf git-reflog-recover-demo
mkdir git-reflog-recover-demo
cd git-reflog-recover-demo
git init -q -b main
git config user.name "Anystack Student"
git config user.email "student@example.com"
printf "safe
" > base.txt
git add base.txt
git commit -q -m "feat: add base"
printf "recover me
" > recover.txt
git add recover.txt
git commit -q -m "feat: add recoverable file"
git reset -q --hard HEAD~1
lost=$(git reflog --format='%H %gs' | awk '/commit: feat: add recoverable file/{print $1; exit}')
git branch recovered "$lost"
printf "main-has-file: "
if git cat-file -e main:recover.txt 2>/dev/null; then echo yes; else echo no; fi
printf "recovered-file: "
git show recovered:recover.txt

预期输出

text
main-has-file: no
recovered-file: recover me

Tips

  • 误操作后减少无关命令,便于 reflog 定位。
  • 找到目标提交后立即创建分支,不要长期依赖 HEAD@{n}。
  • 远程服务器无法替代本地 reflog,重要历史仍应推送备份。

常见错误

1. 只查看普通 log

  • 错误表现:误删提交完全不可见。
  • 产生原因:普通日志只遍历当前可达历史。
  • 正确处理:改用 git reflog 查看引用移动记录。
  • 修复结果:能够定位旧提交并核对内容。

2. 恢复到错误 reflog 条目

  • 错误表现:找回的内容不是目标版本。
  • 产生原因:仅凭序号操作,没有使用 show 验证。
  • 正确处理:先 git show <哈希>,确认后创建恢复分支。
  • 修复结果:恢复结果与目标文件和提交说明一致。

本课练习

1. 恢复误删分支

  • 任务目标:练习引用恢复。
  • 输入或初始条件:创建分支并提交后删除分支。
  • 实现要求:从 reflog 定位并重建。
  • 验收条件:新分支包含原提交。

2. 恢复误 reset 提交

  • 任务目标:练习 HEAD 移动恢复。
  • 输入或初始条件:执行 hard reset 回退两个提交。
  • 实现要求:找出回退前位置并创建标签。
  • 验收条件:标签可访问两个消失提交。

3. 比较本地与远程能力

  • 任务目标:理解 reflog 范围。
  • 输入或初始条件:在两个克隆中进行不同操作。
  • 实现要求:比较各自 reflog。
  • 验收条件:能够说明 reflog 为何不一致。
按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

使用 reflog 找回误删提交

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通