GitHub limited Capacity

参考 https://docs.github.com/zh/repositories/creating-and-managing-repositories/repository-limits

GitHub 仓库与文件大小限制说明

为确保平台性能与可靠性，GitHub 对仓库和文件设置了特定的大小限制。这些限制对于维护平台基础设施稳定及保障用户体验至关重要。

一、文件大小限制

  • 超过 50 MB 的文件：当你尝试添加或更新超过 50 MB 的文件时，GitHub 会发出警告。尽管推送操作仍可成功，但建议移除此类文件，以避免引发性能问题。
  • 超过 100 MB 的文件：GitHub 会阻止上传超过 100 MB 的文件。若需管理此类文件，必须使用 Git 大文件存储（Git Large File Storage，简称 Git LFS）。
  • 浏览器上传限制：通过 GitHub 网页界面添加的文件，大小不能超过 25 MB。

二、仓库大小限制

  • 建议大小：仓库理想情况下应保持在 1 GB 以内，且强烈建议不超过 5 GB。
  • 超出限制的处理：若某个仓库对 GitHub 基础设施造成显著影响，你可能会收到 GitHub 支持团队的通知，要求采取整改措施。

三、大文件管理方法

  1. 使用 Git LFS 跟踪大文件，避免导致仓库体积膨胀1,2。
  2. 若需分发大型二进制文件，可在 GitHub 上创建“发布版本”（Releases）。每个发布版本中的单个文件最大可支持 2 GB1。
  3. 避免使用 Git 存储大型 SQL 文件或备份文件。此类文件应改用文件共享服务或专门的备份工具1。

四、减小仓库体积的方法

  1. 使用 git rm 命令删除不必要的文件，并通过修改提交（amend commits）清理提交历史1。
  2. 执行 git gc 命令压缩 Git 对象，优化存储占用2。
  3. 使用 git-sizer 等工具分析仓库大小，定位导致体积过大的问题区域1,2。

遵循上述指南，你可以有效管理 GitHub 仓库，确保其性能达到最佳状态，同时符合平台的大小限制要求。