如何删除HEAD中已不存在的旧Git历史对象？

git-filter-repo是当前Git官方推荐的历史重写工具，完全适配你的场景——它效率远高于git filter-branch，功能覆盖BFG的需求，尤其适合处理30万提交级别的大型仓库。

核心操作步骤（先备份，再操作） #

1. 镜像克隆原仓库（必须做，避免破坏原数据） #

git clone --mirror <你的原仓库URL> repo-mirror
cd repo-mirror

镜像克隆会完整复制仓库的所有数据，是安全操作的前提。

2. 安装git-filter-repo #

如果你的系统没有预装，用pip安装即可：

pip install git-filter-repo

部分新版Git已集成该工具，可直接执行git filter-repo --version确认是否可用。

3. 仅保留HEAD中存在的文件的完整历史 #

先导出当前HEAD下所有存在的文件列表：

git ls-files > keep-files.txt

然后执行历史重写，只保留这些文件的所有提交痕迹（其他文件的添加、修改记录会被彻底移除）：

git filter-repo --paths-from-file keep-files.txt

这个命令会遍历所有30万次提交，仅保留与目标文件相关的变更：如果某个提交只涉及已删除的文件，该提交会被直接删除；如果提交同时包含保留文件和已删除文件，会保留提交但移除无关文件的变更记录。

4. 彻底清理冗余对象 #

重写历史后，执行强制垃圾回收，清理所有未被引用的对象：

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

5. 推回原仓库 #

因为是镜像克隆，直接强制推送即可覆盖原仓库：

git push

为什么之前的工具没解决问题？ #

• BFG：默认专注于删除历史中的大文件，而非批量移除所有不在当前HEAD的文件；若要实现你的需求，需要手动列出所有要删除的文件，对于长期积累的仓库几乎不可行。
• git filter-branch：效率极低，处理30万提交会耗时极久甚至中途崩溃，且官方已明确废弃。
• svn2git：只是SVN到Git的迁移工具，不具备历史清理的核心能力。

额外优化建议 #

• 如果当前HEAD中的文件存在历史大版本（比如旧的安装包、日志），可以结合--strip-blobs-bigger-than参数进一步压缩体积，例如：

  git filter-repo --paths-from-file keep-files.txt --strip-blobs-bigger-than 10M
  

• 所有开发者需重新克隆仓库，禁止在原仓库基础上拉取合并，否则会引发历史冲突。
• 操作完成后，用git count-objects -vH对比处理前后的仓库体积，确认清理效果。

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