github对文件上传有严格限制：git推送单文件超50mib警告、超100mib禁止；网页上传限25mib；lfs支持单文件达2gib但免费账户每月仅10gib存储+带宽；仓库建议≤10gb，目录条目≤3000个；文本文件超1mb无高亮、超5mb不可预览；diff超2万行或1mb被截断；本地可调http.postbuffer缓解传输问题。
如果您尝试向 GitHub 仓库上传文件，但操作失败或被拦截，则很可能是由于 GitHub 对文件大小设置了多重限制。以下是针对这些限制的具体说明与应对方式：
一、普通文件上传大小限制
GitHub 对直接通过 Git 推送或网页界面上传的文件施加了明确的硬性上限，以保障仓库性能和系统稳定性。超出该限制的文件将被拒绝接收。
1、通过 Git 命令行推送时，单个文件大于 50 MiB 会触发警告提示；大于 100 MiB 的文件将被完全禁止推送。
2、通过 GitHub 网页界面（如“Add file”按钮）上传时，单个文件不得超过 25 MiB。
3、所有仓库中，单个文件最大允许值为 100 MiB，无论推送方式如何，超过即报错“File is too large”。
二、Git LFS 文件大小与配额限制
Git Large File Storage（LFS）是 GitHub 官方推荐的大文件管理方案，它将大文件内容替换为指针并托管在独立存储服务中，从而绕过主仓库的体积限制。
1、启用 Git LFS 后，单个被追踪的文件最大可支持 2 GiB。
2、GitHub 免费账户每月享有 10 GiB 存储空间 + 10 GiB 下载带宽 的 LFS 配额。
3、若超出配额，相关 LFS 文件将无法下载，且推送新 LFS 文件会被拒绝，直到下月重置或升级账户。
三、仓库整体容量与结构限制
除单个文件外，GitHub 还对整个仓库的规模设定多项约束，影响克隆、拉取、浏览等基础操作的可用性与响应速度。
1、建议仓库总磁盘占用（即 .git 目录大小）不超过 10 GB；超过可能导致克隆缓慢、CI 超时或 UI 加载延迟。
系统简介:后台:一、管理员管理，可以修改管理员名称及密码；三、上传管理：此管理在网站基本设置中，可以在增加产品时上传的图片及其他文件。四、企业信息：可设置修改企业的各类信息及介绍。 五、产品管理：产品类别新增修改管理，产品添加修改。六、下载中心：可分类增加各种文件，如驱动和技术文档等文件的下载。七、新闻管理：能分大类和小类新闻，不再受新闻栏目的限制。 八、荣誉管理：新增修改企业荣誉栏目的信息。新增
2、单个目录内文件及子目录条目数不得超过 3,000 个，否则影响 Git 树遍历效率。
3、私有仓库每个最多占用 500 MB（不含 LFS 内容），公共仓库无明确总容量上限，但若单仓持续超过 5 GB，可能收到 GitHub 发送的优化提醒邮件。
四、文本文件与差异查看限制
GitHub 在 Web 界面中对大型文本文件的渲染和代码差异展示也设定了阈值，超出后将降级为纯文本或仅提供原始链接访问。
1、大于 1 MB 的文本文件（如 .sql、.log、.md）在网页中默认显示为无语法高亮的纯文本。
2、大于 5 MB 的文本文件无法在页面内预览，仅可通过 Raw 按钮跳转至源 URL（格式为 https://[hostname]/user/repo/raw/branch/path/file）。
3、任意文件的 diff 行数超过 20,000 行 或差异数据体积超 1 MB，该部分差异将被截断不显示。
五、临时提升推送缓冲区的方法
虽然不能突破 GitHub 服务器端的 100 MiB 文件上限，但本地 Git 客户端的 HTTP 缓冲区过小可能导致小于 100 MiB 的文件推送失败（尤其在网络不稳定时）。此配置仅影响传输过程，不改变服务端策略。
1、打开终端，进入目标仓库根目录。
2、执行命令：git config http.postBuffer 524288000（设置为 500 MiB 缓冲）。
3、验证是否生效：运行 git config -l | grep postBuffer，确认输出包含刚设置的值。
