首页/开发/Git 与协作速查/GitHub 大文件限制与应对
进阶与大仓实践69 条

GitHub 大文件限制与应对

GitHub 对单文件推送有硬限制:超过 100 MiB 的推送会被拒绝,超过 50 MiB 会给出警告;大文件应改用 Git LFS 或制品库。

Git 与协作速查开发更新于 2026-10-12
推送硬限单文件超过 100 MiB 会被阻止
警告阈值超过 50 MiB 提示
推荐二进制素材/模型改用 LFS;构建产物走发布附件或制品库

排查与处理

排查与处理
git rev-list --objects --all \
  | git cat-file --batch-check='%(objecttype) %(objectname) %(objectsize) %(rest)' \
  | awk '$1 == "blob" && $3 > 52428800 {print $3, $4}' | sort -nr | head
# 确认后迁移 LFS 或从历史移除
把大文件从历史移除需要重写提交,团队协作流程按历史改写清单执行。

易错点

  • 已进入历史的超大文件不清历史就一直在仓库里,即使当前提交已删除
  • 不同托管平台限额不同,自建 GitLab 以实例配置为准,勿照搬数值

数据来源与参考

  • GitHub Docs:About large files on GitHub(文件大小限制)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌