如何移除提交历史中的GitHub超大文件并保留其他修改

方法一：使用git filter-repo（官方推荐的高效方案） #

这是Git官方指定的历史重写工具，比旧版git filter-branch更安全高效。

• 先备份本地仓库：复制整个项目文件夹到其他位置，防止操作失误丢失数据。
• 安装git filter-repo：如果Git未自带该工具，用系统包管理器安装（Mac用brew install git-filter-repo，Linux用sudo apt install git-filter-repo，Windows可执行pip install git-filter-repo）。
• 移除历史中的超大文件：在仓库根目录执行命令，替换<超大文件路径>为实际文件的相对路径（比如assets/large_dataset.zip）：

  git filter-repo --path <超大文件路径> --invert-paths
  

• 验证修改：执行git log确认包含超大文件的提交已被移除；执行git ls-files确认当前工作区无该文件。
• 强制推送远程分支：由于重写了历史，需要强制覆盖远程分支，替换<你的分支名>为实际分支名（比如main或dev）：

  git push origin <你的分支名> --force
  

方法二：基于正常提交重建分支（适合新手手动操作） #

若对历史重写工具感到陌生，可手动基于最后一个无超大文件的提交重建分支：

1. 定位最后一个正常提交哈希：执行git log，找到添加超大文件前的提交，记录其哈希值（比如a1b2c3d）。
2. 创建新分支：基于上述正常提交创建新分支，替换<新分支名>和<正常提交哈希>：

   git checkout -b <新分支名> <正常提交哈希>
   

3. 迁移除超大文件外的所有修改：
   • 切换回原分支：git checkout <原分支名>
   • 获取需迁移的文件列表（排除超大文件），替换<超大文件路径>：

     git diff <正常提交哈希> <原分支名> --name-only | grep -v <超大文件路径>
     

   • 切换回新分支，迁移这些文件的修改：

     git checkout <新分支名>
     git checkout <原分支名> -- $(git diff <正常提交哈希> <原分支名> --name-only | grep -v <超大文件路径>)
     

4. 提交迁移的修改：

   git add .
   git commit -m "保留原有修改，移除超大文件"
   

5. 替换原分支（可选）：若需用新分支替换原分支，执行：

   git checkout <原分支名>
   git reset --hard <新分支名>
   

6. 强制推送远程分支：

   git push origin <原分支名> --force
   

注意事项 #

• 强制推送会覆盖远程分支历史，若有协作者，需提前告知他们重新拉取分支，避免基于旧历史提交代码引发冲突。
• 无论采用哪种方法，操作前备份仓库都是必要的，防止意外丢失数据。

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