如何移除Git仓库历史中已删除的大Access DB文件？

问题背景 #

仓库历史中存在已删除的大体积Access DB文件（ad_hoc/DM_Analyse/202011221_Output.accdb），通过git-sizer已定位到其Blob哈希为f660c63e4d46e5b78d384b08814b9ea20f164952，但常规git filter-branch命令无法移除，推测文件仅存在于已删除分支的孤立提交中。

有效解决步骤 #

1. 使用git filter-repo重写历史（官方推荐替代filter-branch） #

git filter-repo能扫描所有可达提交（包括孤立历史），比filter-branch更可靠彻底：

• 若已安装git filter-repo，直接执行以下命令移除指定文件：

  git filter-repo --invert-paths --path-from-file <(echo "ad_hoc/DM_Analyse/202011221_Output.accdb")
  

• 或者直接通过Blob哈希精准删除：

  git filter-repo --blob-callback 'if blob.id == b"f660c63e4d46e5b78d384b08814b9ea20f164952": blob.skip()'
  

  注：若未安装git filter-repo，可通过包管理器（如brew、apt）安装，或从官方源码构建

2. 清理本地残留对象并回收空间 #

重写历史后，清理Git的松散对象和引用日志：

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

3. 强制同步到远程仓库（注意风险） #

若仓库为共享协作模式，需强制推送改写后的历史，同时通知所有协作成员重新克隆仓库（避免历史冲突）：

git push --force --all
git push --force --tags

关键说明 #

git filter-branch失效的原因是：--all仅覆盖现有分支和标签的历史，而孤立提交（已删除分支的残留历史）不在其处理范围内。git filter-repo会遍历所有可达的Git对象，包括这些孤立提交，因此能彻底清除目标文件的所有痕迹。

内容的提问来源于stack exchange，提问作者Jörg