版本控制与协作 / 系统课时
使用 reflog 找回误删提交
使用 reflog 找回误删提交
学习目标
完成本课后,你将能够:
- 说明 reflog 记录引用移动历史
- 定位 reset 或删除分支前的提交
- 通过新分支恢复不可达提交
问题背景或应用场景
误执行 reset、删除分支或在分离 HEAD 中提交后,提交可能从普通 git log 消失,但对象通常不会立刻被垃圾回收。reflog 记录本地引用曾经指向的位置,为恢复提供短期线索。
核心原理
reflog 是本地仓库日志,常见条目包括提交、切换、合并、变基和重置造成的引用移动。HEAD@{1} 表示 HEAD 的上一个记录位置,但序号会随新操作变化,因此恢复时最好复制具体提交哈希。
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 meTips
- 误操作后减少无关命令,便于 reflog 定位。
- 找到目标提交后立即创建分支,不要长期依赖
HEAD@{n}。 - 远程服务器无法替代本地 reflog,重要历史仍应推送备份。
常见错误
1. 只查看普通 log
- 错误表现:误删提交完全不可见。
- 产生原因:普通日志只遍历当前可达历史。
- 正确处理:改用
git reflog查看引用移动记录。 - 修复结果:能够定位旧提交并核对内容。
2. 恢复到错误 reflog 条目
- 错误表现:找回的内容不是目标版本。
- 产生原因:仅凭序号操作,没有使用 show 验证。
- 正确处理:先
git show <哈希>,确认后创建恢复分支。 - 修复结果:恢复结果与目标文件和提交说明一致。
本课练习
1. 恢复误删分支
- 任务目标:练习引用恢复。
- 输入或初始条件:创建分支并提交后删除分支。
- 实现要求:从 reflog 定位并重建。
- 验收条件:新分支包含原提交。
2. 恢复误 reset 提交
- 任务目标:练习 HEAD 移动恢复。
- 输入或初始条件:执行 hard reset 回退两个提交。
- 实现要求:找出回退前位置并创建标签。
- 验收条件:标签可访问两个消失提交。
3. 比较本地与远程能力
- 任务目标:理解 reflog 范围。
- 输入或初始条件:在两个克隆中进行不同操作。
- 实现要求:比较各自 reflog。
- 验收条件:能够说明 reflog 为何不一致。
按自己的节奏,确认真正理解。