暂存并取消暂存大文件后，如何恢复.git文件夹的原始大小？

误执行git add <large_file>后，大文件会被Git以对象形式存入.git/objects目录，仅用git rm --cached取消暂存无法删除这些对象，git gc默认也不会清理未被引用的松散对象，甚至可能因打包操作让体积进一步增大。以下是彻底恢复的方法：

方法一：手动清理未被引用的大对象 #

1. 定位大对象ID

   • 查看所有未被引用的对象：

     git fsck --unreachable
     

   • 找出体积最大的对象（适用于已打包的情况）：

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

   • 如果记得大文件名，可尝试关联对象ID：

     git rev-list --objects --all | grep <large_file>
     

2. 删除对象并清理

   • 若为松散对象（路径格式为.git/objects/[前两位]/[后38位]），直接删除对应文件：

     rm .git/objects/xx/xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
     

   • 若对象已被打包，强制重新打包并清理：

     git repack -Ad
     git gc --prune=now
     

方法二：用git-filter-repo彻底移除（推荐） #

git-filter-repo是Git官方推荐的仓库历史修改工具，能彻底清除大文件的所有痕迹：

1. 安装git-filter-repo（部分Git版本已内置，若没有可通过包管理器安装）
2. 执行命令移除指定大文件：

   git filter-repo --invert-paths --path <large_file>
   

执行后，.git目录体积会回到从未添加过该大文件的状态。

注意事项 #

• 操作前备份当前工作区的重要修改，避免数据丢失
• 若为远程共享仓库，清理后需执行git push --force覆盖远程分支，其他协作者需重新克隆仓库或同步更新

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