使用Git LFS推送大型TensorFlow模型到GitHub仓库报错如何解决？

问题核心原因 #

• 安装Git LFS包后未执行仓库级别的初始化命令，LFS钩子未生效
• 配置LFS跟踪规则前，目标大文件已被纳入普通Git提交历史，Git仍将其作为普通文件推送触发大小限制

解决步骤 #

• 首先在当前仓库执行Git LFS初始化：
  git lfs install
• 处理Git历史中的大文件：
  • 如果仅最近一次提交包含大文件，先撤销该次提交、保留工作区文件：
    git reset HEAD~1
  • 如果大文件已经存在于更早的提交历史中，执行LFS历史迁移命令，将所有匹配后缀的历史文件转为LFS存储对象：
    git lfs migrate import --include="*.h5,*.zip,*.json"
• 验证LFS配置生效，执行以下命令，确认输出中包含my_big_model.zip和tf_model.h5的路径：
  git lfs ls-files
• 重新提交并推送即可：

git add .
git commit -m "migrate large files to LFS"
git push origin master

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