Git reflog：恢复误删分支、丢失提交的 “救命” 命令详解

在软件开发中，误删分支或丢失提交是常见问题。Git 的 reflog 命令就像一个“时间机器”，记录所有引用变更历史，帮你找回丢失的数据。本文将一步步解释如何用它恢复误删分支和提交，并提供实用示例。记住，reflog 只记录本地操作，日志会随时间过期（默认90天），所以及时行动很重要。

什么是 Git reflog？

reflog（引用日志）是 Git 的隐藏日志，记录 HEAD 和分支的所有移动。每当分支切换、提交或重置时，Git 都会自动记录这些操作。它不是版本库的一部分，而是本地存储的，主要用于调试和恢复意外操作。运行 git reflog 命令，你会看到类似这样的输出：

f1b5d8a HEAD@{0}: commit: 添加新功能
a9c3e2d HEAD@{1}: checkout: 从 main 切换到 feature
...

每个条目包含提交哈希、操作类型和时间戳。通过分析这些记录，你能找到误删前的状态。

如何恢复误删分支？

误删分支后，别慌！reflog 能帮你找回。以下是清晰步骤：

1. 查看 reflog 日志：打开终端，运行 git reflog。浏览输出，找到删除分支的记录。例如：

   git reflog
   # 输出类似：a9c3e2d HEAD@{2}: checkout: 从 feature 切换到 main
   #           b4d7f1c HEAD@{3}: branch: 删除分支 feature
   

   这里，HEAD@{3} 是删除分支的时刻，a9c3e2d 是删除前的提交哈希。

2. 识别旧分支状态：确定删除分支的名称和它指向的提交。假设误删的分支是 feature，删除前的提交哈希是 a9c3e2d。

3. 恢复分支：基于找到的提交哈希，创建新分支。命令为：

   git branch <新分支名> <提交哈希>
   

   例如：

   git branch recovered_feature a9c3e2d
   

   现在，运行 git branch 检查，recovered_feature 分支已恢复。

整个过程只需几分钟。如果分支有未推送的更改，reflog 也能救回，但需确保日志未过期。

如何恢复丢失提交？

有时，错误重置或修改导致提交丢失。reflog 同样适用：

1. 定位丢失提交：运行 git reflog，搜索丢失提交的记录。例如：

   git reflog
   # 输出：c3f8a9b HEAD@{4}: commit: 修复 bug
   #        d2e4f6a HEAD@{5}: reset: 移动到 HEAD~1
   

   假设 c3f8a9b 是丢失的提交哈希。

2. 恢复提交：有两种方法：

   • 创建新分支：直接基于提交哈希建分支：

     git branch saved_commit c3f8a9b
     

   • 重置当前分支：如果丢失提交在历史中，用 git reset 回退：

     git reset --hard c3f8a9b  # 谨慎使用，会覆盖未提交更改
     

   或者用 git cherry-pick 提取提交到当前分支：

   git cherry-pick c3f8a9b
   

完整示例：实战恢复

假设你误删了 dev 分支。以下是模拟场景：

1. 删除分支：

   git branch -d dev  # 误删操作
   

2. 查看 reflog 找记录：

   git reflog
   # 输出：e1f2a3b HEAD@{1}: branch: 删除分支 dev
   #        a0b1c2d HEAD@{2}: commit: 更新文档
   

3. 恢复分支（基于 a0b1c2d 哈希）：

   git branch restored_dev a0b1c2d
   

4. 验证：

   git checkout restored_dev
   git log  # 查看历史，确认恢复成功
   

注意事项

• 日志过期：reflog 条目默认保留 90 天。用 git reflog expire 管理，但别随意清理，以免失去恢复机会。
• 本地性：reflog 只记录本地操作。误删后，如果仓库被克隆或重置，日志可能丢失。
• 安全操作：恢复前，建议备份当前状态：git stash save "临时保存"。
• 替代工具：如果 reflog 无效，试试 git fsck 找悬空对象，但更复杂。

总结

git reflog 是开发者的“救命稻草”，能轻松恢复误删分支或丢失提交。通过简单命令，你能回溯时间，避免数据灾难。养成定期提交的好习惯，并熟悉 reflog，让你的 Git 工作流更可靠。遇到问题时，冷静执行上述步骤，大部分丢失都能挽回！