首页/开发/代码质量与评审速查/评审检查项:大文件与二进制
代码评审64 条

评审检查项:大文件与二进制

大文件与二进制评审:构建产物、数据集、媒体文件是否应入库;二进制不可评审,且会让仓库历史体积不可逆增长。

  • 构建产物不入库:dist、jar、编译结果由流水线生成
  • 大文件(模型、数据集、视频)用对象存储或 Git LFS,并确认配额
  • 入库前先问:能否生成?能否下载?是否有替代托管?
  • 图片等资源:控制体积,必要时压缩后入库
Git 历史不可逆:大文件一旦合入,清理需要重写历史(如 git filter-repo)。
入库判断能生成走流水线;大素材用 LFS 或对象存储
复查方式提交前检查体积,超过约定阈值即拦截

易错点

  • 把安装包或数据集直接 git add:仓库膨胀且难以回退
  • 以为删掉文件就恢复体积:历史对象仍在,需要重写历史

数据来源与参考

  • GitHub Docs · About large files on GitHub
  • Git LFS 官方文档
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌