如何将Git项目恢复至刚克隆时的初始大小？

问题背景 #

克隆其他团队的项目后，运行几次发现项目体积从2MB暴涨到190MB，排查后确认是.git/objects文件夹过大导致。尝试git gc --prune=now --aggressive无效，清理大.pack文件后仍有200MB的pack文件残留，不想重新克隆，希望恢复到刚克隆时的状态，最终采用删除重克隆作为临时方案。

可行解决步骤 #

如果不想重新克隆，可以按以下步骤尝试彻底清理Git仓库：

1. 备份当前项目
   操作前先复制整个项目文件夹到其他位置，避免操作失误导致代码丢失。

2. 定位大对象
   先找出.git/objects里占用空间最大的对象：

   git verify-pack -v .git/objects/pack/*.idx | sort -k 3 -n | tail -10
   

   输出结果里最后几行就是最大的对象SHA值，接着用下面的命令找出该SHA对应的文件路径：

   git rev-list --objects --all | grep <上面得到的SHA值>
   

3. 清理历史中的大文件
   如果大文件是被误提交到Git历史中（即使后来删除了，历史记录里仍会留存），用git filter-repo工具彻底移除历史中的该文件（git filter-branch已被废弃，推荐使用filter-repo）：

   git filter-repo --path <大文件的完整路径> --invert-paths
   

4. 强制清理Git缓存
   执行完上面的操作后，再强制清理所有过期的引用和对象：

   git reflog expire --expire=now --all
   git gc --prune=now --aggressive
   

5. 重置到初始克隆状态
   如果上面的方法还是无效，可以尝试直接重置到克隆时的初始提交，同时清理本地多余分支：

   • 先找到克隆时的初始提交SHA：

     git log --oneline | tail -1
     

   • 强制重置到该提交：

     git reset --hard <初始提交SHA>
     

   • 删除所有非主分支（假设主分支是main）：

     git branch -D $(git branch | grep -v main)
     

   • 再次执行清理命令：

     git reflog expire --expire=now --all
     git gc --prune=now --aggressive
     

临时方案说明 #

如果以上所有操作都无法将仓库体积降到初始状态，重新克隆确实是最直接的办法——因为本地Git仓库可能积累了大量未被正确清理的引用、临时对象或隐藏分支，手动清理的成本远高于重新克隆。

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