如何移除已推送到远程的含大文件的特定Git提交？

为什么你之前的rebase操作没生效？ #

git rebase -i的drop操作仅移除指定提交，但如果后续提交依赖该提交的文件快照，或是远程仓库的旧提交仍在引用日志（reflog）中未被清理，就会导致大文件残留。要彻底清除历史中的大文件，推荐使用更可靠的git filter-repo工具。

具体解决步骤 #

• 定位大文件所在提交
  先找到包含视频文件的提交哈希，执行：

  git log --all --oneline --stat | grep -E "(视频文件名|MB)"
  

  或直接按文件名搜索：

  git log --all --oneline --grep="test-video.mp4"
  

  记录下对应的提交哈希（比如a1b2c3d）。

• 用git filter-repo彻底清除文件
  该工具会重写整个仓库的提交历史，彻底移除所有提交中指定的视频文件：

  git filter-repo --path path/to/test-video.mp4 --invert-paths
  

  替换path/to/test-video.mp4为你实际的视频文件路径。

• 强制推送重写后的历史
  用更安全的--force-with-lease替代--force，避免覆盖其他协作者的未推送修改：

  git push origin main --force-with-lease
  

  替换main为你的分支名。

• 清理本地和远程冗余数据
  本地清理所有过期的Git对象：

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

  远程仓库（如GitHub/GitLab）会自动后台清理冗余对象；若为自建仓库，需在服务器端执行git gc --prune=now。

注意事项 #

• 若仓库有其他协作者，必须通知所有人重新克隆仓库，因为历史已被重写，本地旧分支无法正常合并。
• 后续提交前，建议用.gitignore规则排除测试用视频、二进制文件等，避免再次出现此类问题。

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