如何彻底删除Git中已提交的大文件？

一、使用git filter-repo（官方推荐，高效可靠） #

git filter-repo是Git官方替代旧版filter-branch的历史改写工具，能彻底从提交历史和对象库中移除指定文件。

• 先做好仓库备份（避免操作失误导致数据丢失）
• 安装git filter-repo：
  • Ubuntu/Debian：sudo apt install git-filter-repo
  • macOS：brew install git-filter-repo
• 移除已知路径的大文件：直接指定文件路径，遍历全历史删除：

  git filter-repo --path 大文件1路径 --path 大文件2路径 --invert-paths
  

• 移除最后一次提交中的大文件：
  1. 用git log --oneline获取最后一次提交的哈希值
  2. 执行命令过滤该提交中的大文件（替换哈希和文件后缀）：

  git filter-repo --commit-callback 'if commit.original_id == b"你的提交哈希":
      commit.file_changes = [fc for fc in commit.file_changes if not fc.filename.endswith(b".大文件后缀")]'
  

  若最后一次提交仅包含大文件，也可先重置到上一次正常提交，再清理残留：

  git reset --hard HEAD~1
  git filter-repo --cleanup=force
  

二、手动清理Git对象库（应急方案） #

若暂时无法使用git filter-repo，可手动清理未被引用的对象：

1. 重置到最后一个正常提交：

   git reset --hard 正常提交的哈希值
   

2. 清理引用日志（清除被重置提交的记录）：

   git reflog expire --expire=now --all
   

3. 强制垃圾回收，彻底删除无引用的对象：

   git gc --prune=now --aggressive
   

后续注意事项 #

• 历史改写后，需强制推送到远程仓库：git push origin 你的分支名 --force，务必告知协作成员同步操作，避免冲突
• 后续添加大文件前，先初始化Git LFS：git lfs install，再追踪文件：git lfs track "*.大文件后缀"，确保大文件通过LFS存储

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