如何通过清理二进制文件缩小Git的pack文件及仓库体积

你之前执行的删除当前版本二进制文件夹、git gc/git prune等常规清理命令无效，核心原因是二进制文件仍然存在于历史提交的快照中，Git默认不会主动清理历史中遗留的大对象。

批量清理操作步骤 #

操作前请先完整备份整个仓库，避免操作失误丢失数据。

方案1：使用官方推荐的git filter-repo（操作更简单、效率更高） #

• 首先在环境中安装git filter-repo工具，部分Git安装包默认未附带该工具，需单独安装
• 进入仓库根目录，执行如下命令批量删除所有历史提交中的指定二进制文件夹，将下方的your_binary_dir替换为你实际存放二进制文件的文件夹路径：
  git filter-repo --path your_binary_dir --invert-paths
  该命令会自动遍历所有历史提交、标签，批量移除匹配路径下的所有内容，无需逐个处理文件。
• 执行空间回收命令彻底清除冗余对象：
  git reflog expire --expire=now --all && git gc --prune=now --aggressive

方案2：使用传统git filter-branch（无需额外安装工具） #

如果无法安装git filter-repo，可使用Git原生自带的命令实现相同效果：

• 进入仓库根目录，执行如下命令，将下方的your_binary_dir替换为实际的二进制文件夹路径：
  git filter-branch --force --index-filter 'git rm -rf --cached --ignore-unmatch your_binary_dir' --prune-empty --tag-name-filter cat -- --all
  该命令会遍历所有历史提交，批量删除对应文件夹的所有内容，自动过滤空提交，同时保留原有标签信息。
• 执行和方案1相同的空间回收命令即可。

后续注意事项 #

• 清理完成后如果需要推送到远程仓库，需执行强制推送：
  git push origin --force --all
  如果需要同步标签，额外执行：
  git push origin --force --tags
• 所有仓库协作者后续拉取更新时，需执行变基拉取操作，避免将本地缓存的旧版大对象重新提交到仓库
• 后续建议将二进制文件夹路径添加到.gitignore文件中避免误提交，如有存储二进制文件的需求，可配置Git LFS管理大文件，避免大文件直接存入Git对象库占用空间。

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