github 是全球知名的代码托管平台，对于开发者而言，准确掌握其仓库容量上限及免费账户的限制规则至关重要。
在仓库容量方面，GitHub 免费账户并未设定绝对统一的“单仓 1 GB 封顶值”，而是采用分层管控机制：官方强烈建议单个仓库体积保持在 1 GB 以内，以确保克隆、拉取、推送等 Git 操作的响应速度与稳定性；若仓库持续增长至 5 GB，用户可能收到来自 GitHub 支持团队的优化提示邮件；达到 75 GB 时，git push 命令将直接触发终端警告；而当前确认的硬性推送拦截阈值为 100 GB——超出此值可能导致提交被拒绝或仓库临时锁定。
此外，私有仓库受更严格约束：每个免费账户创建的私有仓库独立受限于 500 MB 总容量（含全部历史提交对象、分支、标签及 .git 数据库压缩后大小），该限制不可绕过，且不与公共仓库共享配额。
文件级限制同样关键：
- 网页端上传单文件上限为 25 MB；
- Git 命令行推送单文件不得超过 100 MB，否则报错
GH001: Large files detected； - 对 ≥50 MB 的文件，Git 客户端会在推送前发出本地警告，推荐改用 Git LFS 托管。
针对大文件场景，GitHub 提供 Git LFS 作为合规替代方案：免费账户享有 每月 10 GiB 存储 + 10 GiB 带宽 配额，LFS 托管的单文件最大支持 2 GB，且不占用所属仓库的 500 MB 或 1 GB 主容量；但一旦月度配额耗尽，新上传将被拒绝，已有文件仍可下载但不可更新版本。
还需注意若干隐性规模限制：单仓库内文件总数不宜超过 100,000 个，否则易引发索引延迟与操作卡顿；.git 目录实际磁盘占用建议控制在 10 GB 以内，避免 CI 超时或 UI 加载缓慢；单目录下文件及子目录条目数不得超过 3,000 个，以防 Git 树遍历效率下降。
尽管存在上述限制，GitHub 免费账户仍具备显著优势：私有仓库数量无上限（自 2019 年起永久生效），且所有仓库在账户有效前提下长期存续；公共仓库亦无明确总容量限制，仅建议单仓 ≤1 GB 以保障性能。对多数个人项目、学习仓库、轻量级开源组件而言，合理使用 Git LFS 并定期清理大文件历史（如通过 git filter-repo 或 BFG Repo-Cleaner），完全可在免费框架内高效运转。
当项目演进至接近 500 MB（私有）或 1 GB（公共）临界点时，开发者宜提前评估是否需启用 LFS、归档旧分支或升级至 Team 计划——后者不仅提供更大仓库容量（如 2 GB / 5 GB），还开放无限协作者、高级安全策略、增强型 CI/CD 分钟数等能力，从而更稳健地支撑中大型团队协作与规模化工程实践。
