GitHub免费账户仓库容量限制包括：单仓库推荐<1GB、硬限100GB；私有仓库限500MB；单文件网页上传≤25MB、Git推送≤100MB；Git LFS配额10GiB/月；另有限制文件总数≤10万、单次push≤2GB、单目录条目≤3000。
如果您在使用 GitHub 免费账户时发现仓库推送失败、克隆缓慢或收到系统警告邮件，则很可能是触及了 GitHub 对仓库容量的多项限制。以下是针对免费账户的仓库容量上限及配套规则的详细解析：
一、单仓库体积推荐与硬性上限
GitHub 并未为免费账户设定绝对不可逾越的“封顶值”，但通过官方建议与实际行为可明确两级阈值：推荐上限与干预临界点。超过推荐值将影响性能，达到硬上限则触发平台干预。
1、推荐保持单仓库体积小于 1 GB，以保障克隆、拉取、推送等基础 Git 操作响应及时；
2、当仓库体积达到5 GB时，用户可能收到来自 GitHub 支持团队的优化提示邮件；
3、若仓库持续增长至75 GB，终端执行 git push 时会直接显示 Git 警告；
4、当前确认的硬性限制为100 GB，超出此值可能导致推送被拒绝或仓库被临时锁定。
二、私有仓库专属容量约束
免费账户创建的私有仓库受更严格的独立配额管控，该限制不与公共仓库共享，也不计入账户总容量，而是按仓库粒度强制执行。
1、每个私有仓库最大允许占用500 MB存储空间；
2、一旦单个私有仓库文件内容（含历史提交对象）累计超过 500 MB，后续 push 将被拒绝，且无法通过常规方式绕过；
3、该限制适用于所有提交记录中的对象，包括已删除但未彻底清除的历史大文件。
三、单文件大小拦截机制
GitHub 在文件写入环节实施前置校验，阻止超限文件进入 Git 对象数据库，该机制独立于仓库总体积，具有即时生效性。
1、通过网页界面上传时，单文件最大允许25 MB；
2、通过 Git 命令行推送时，单文件硬限制为100 MB，超过即报错 “GH001: Large files detected”；
3、对大于 50 MB 的文件，Git 客户端会在推送前发出本地警告，提示使用 Git LFS 替代。
四、Git LFS 配额替代方案
对于需长期托管音视频、数据集、编译产物等大文件的场景，GitHub 提供 Git LFS 作为合规路径，其配额与主仓库分离，但受账户类型制约。
1、免费账户每月享有10 GiB 存储 + 10 GiB 带宽的 LFS 配额；
2、LFS 托管的单个文件最大支持2 GB，且不占用所属仓库的 500 MB 或 1 GB 主容量；
3、LFS 文件对象一旦超出月度配额，新上传将被拒绝，已有文件仍可下载，但无法更新版本。
五、关联性隐性限制
除显性容量数值外，GitHub 还通过若干间接指标控制仓库健康度，这些限制虽无明确字节标定，但实际构成容量管理的重要组成部分。
1、单仓库内文件总数不应超过100,000 个，否则可能引发索引延迟与操作超时；
2、单次 push 操作所涉及的对象总大小建议不超过2 GB，否则易因超时中断；
3、单目录下条目数（文件+子目录）不得超过3,000 个，否则显著拖慢 git status 和 git log 等命令响应速度。
