删除大文件后执行git filter-branch仍无法推送到GitHub求助

问题根源分析 #

首先，你遇到的两个问题本质是两回事：

• 推送仍失败：你只是删除了当前工作区的大文件，但Git的历史提交里还保留着这个文件的快照。GitHub的预接收钩子会扫描所有提交内容，所以即使现在工作区没有，历史里的大文件还是会触发大小限制错误。
• filter-branch语法错误：你命令里的<pagerank>是占位符标记，实际执行时需要去掉尖括号，换成真实的目录/文件路径，而且要注意大小写——从报错信息看，你的大文件路径是Pagerank/spider.sqlite，不是小写的pagerank，大小写不匹配也会导致问题。

分步解决方案 #

1. 彻底从历史中移除大文件

修正git filter-branch命令，去掉尖括号并使用正确的路径：
如果你想移除整个Pagerank目录：

git filter-branch --index-filter 'git rm -r --cached --ignore-unmatch Pagerank' HEAD

如果只想精准移除那个大文件spider.sqlite：

git filter-branch --index-filter 'git rm --cached --ignore-unmatch Pagerank/spider.sqlite' HEAD

执行成功后，Git会重写所有包含该文件的历史提交。

2. 强制推送改写后的历史

因为你修改了Git的提交历史，普通推送会被拒绝，需要用强制推送覆盖远程分支：

git push -u origin master --force

注意：如果这是多人协作的仓库，强制推送会覆盖其他人的提交，务必确认只有你在使用这个分支。

3. 清理本地冗余对象（可选）

重写历史后，本地会留下很多无用的旧提交对象，可以执行以下命令清理：

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

验证结果 #

执行完以上步骤后，再运行git status确认工作区干净，然后重新推送，应该就能成功了。

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