iOS Swift项目因150MB OpenCV框架无法推送至GitHub，已用Git LFS仍报错求助

这个问题我之前帮不少iOS开发者解决过——你遇到的核心问题是Git LFS的追踪规则只对新提交生效，但你的历史提交记录里已经存在这个150MB的OpenCV文件，GitHub的预接收钩子会扫描整个提交历史，所以光添加追踪规则没用，得先清理历史再重新推送。下面是具体的解决步骤：

第一步：确保Git LFS正确配置并追踪目标文件 #

先确认你的Git LFS已经正常工作，重新设置追踪规则：

• 初始化Git LFS（如果还没做过）：

  git lfs install
  

• 重新追踪目标大文件：

  git lfs track "Pods/OpenCV/opencv2.framework/Versions/A/opencv2"
  

• 提交.gitattributes文件（这个文件存储LFS的追踪规则）：

  git add .gitattributes
  git commit -m "Track OpenCV framework with Git LFS"
  

第二步：清理历史提交中的大文件 #

这一步是关键，因为GitHub会检查所有历史提交里的文件大小。我们用git filter-repo工具（官方推荐替代旧的filter-branch，更安全高效）来移除历史中的大文件：

1. 先备份整个项目文件夹！重写历史有风险，备份能防止数据丢失。
2. 运行命令移除历史中的目标文件：

   git filter-repo --path Pods/OpenCV/opencv2.framework/Versions/A/opencv2 --invert-paths
   

   这个命令会重写所有提交历史，把指定的大文件从每一次提交中移除。

第三步：强制推送到远程仓库 #

因为我们重写了提交历史，所以需要用强制推送覆盖远程仓库的历史：

git push origin master --force

（如果你的主分支是main，把命令里的master换成main即可）

额外推荐：更优的CocoaPods管理方式 #

其实对于iOS项目，不建议把Pods目录提交到Git仓库，这是CocoaPods的最佳实践之一：

• 在你的.gitignore文件中添加一行：Pods/
• 提交.gitignore的修改，之后只提交Podfile和Podfile.lock
• 其他开发者拉取项目后，只需要执行pod install就能自动安装所有依赖，包括OpenCV框架，完全不用处理大文件推送的问题。

内容的提问来源于stack exchange，提问作者AJ Z.