首次提交前误执行git reset --hard如何恢复被删除文件

只要你执行git add -A后没有手动跑过git gc、没有大量往仓库所在磁盘写入新数据，文件有极大概率可以恢复。核心依据是：git add操作会把所有暂存文件的完整内容以blob对象的形式写入.git/objects目录，哪怕没有任何提交、没有绑定分支引用，这些松散对象默认会保留14天，不会被Git自动清理。

第一步：第一时间冻结仓库所在分区 #

• 立刻停止在误操作仓库目录下的所有写操作，不要新建文件、不要执行其他Git指令，避免新写入的数据覆盖.git/objects下残存的blob对象，一旦被覆盖文件就彻底无法找回。

第二步：从Git松散对象中提取已暂存的文件内容 #

直接在仓库根目录执行以下命令，批量导出所有残存的blob内容到独立的恢复目录：

# 先在仓库路径外新建恢复目录，避免破坏原有仓库数据
mkdir -p ~/git-config-recovered
cd /path/to/your/broken/repo

# 扫描所有未被引用的blob对象，逐个导出内容
git fsck --full --no-reflogs --unreachable --lost-found | awk '/dangling blob/ {print $3}' | while read blob_hash; do
  git cat-file -p $blob_hash > ~/git-config-recovered/$blob_hash
done

执行完成后，你可以打开~/git-config-recovered目录查看所有导出的文件：

注意：由于你从未执行过git commit，存储文件路径、文件名信息的tree对象没有被Git持久化保存，所以导出的文件是以blob哈希值命名的，没有原始目录结构和文件名，你需要根据文件内容自行识别、重命名、放回对应路径。

如果导出的文件不全，你可以直接去.git/lost-found/other目录下查看，上面的命令执行时git fsck已经把所有找到的孤立对象存到了这个路径下。

第三步：blob扫描不全时的磁盘级恢复方案 #

如果上述步骤找到的文件缺失较多（通常只有你在误操作后手动执行过git gc、或者仓库所在磁盘有大量写入时才会出现），就需要用磁盘恢复工具直接扫描分区找回被删除的文件：

• Windows系统可使用DiskGenius、Recuva扫描仓库所在盘符
• Linux系统可使用testdisk、extundelete扫描对应分区
• macOS系统可使用Disk Drill扫描系统盘

磁盘恢复的成功率和误操作后的磁盘写入量强相关，操作越及时、写入数据越少，恢复成功率越高。

之前尝试的方案无效的原因 #

所有依赖HEAD引用、提交历史的Git恢复指令，在无任何提交的新仓库里都无法生效：

• git reset --hard HEAD~1、git checkout类指令需要HEAD指向一个有效提交，新仓库未产生第一次提交时HEAD处于未绑定状态，没有可回退的版本
• 直接浏览.git目录找不到原始文件是因为Git把所有文件内容存在哈希命名的objects目录中，不会保留原始文件名结构
• Git通过指令删除的工作区文件不会进入系统回收站，所以在回收站里找不到是正常现象

后续避坑建议 #

• 执行git init后优先编写.gitignore规则，确认排除目录正确后再执行git add操作
• 未产生第一次提交前，要撤销暂存区内容请执行git rm --cached -r .，不要使用git reset --hard
• 重要配置文件做Git操作前务必先做备份，哪怕只是打个压缩包存到其他路径

内容的提问来源于stack exchange，提问作者DirkLangohr