GitHub免费账户可创建无限私有仓库且永久有效,但每仓限3名协作者、500MB容量,并需用Git LFS处理大文件(每月10GiB配额);公仓无容量上限但建议≤1GB。

如果您在 GitHub 上创建仓库,但不确定其是否长期可用或受哪些条件约束,则需明确其免费账户的仓库存续机制与使用边界。以下是关于 GitHub 永久免费仓库及其配套限制的详细说明:
一、免费账户可创建无限数量的私有仓库
自 2019 年起,GitHub 免费账户已取消私有仓库数量上限,允许用户创建无限个私有仓库,且这些仓库在账户持续有效前提下永久存在,不因时间推移而自动删除或降级。该政策适用于所有个人免费账户,无需订阅任何付费计划。
1、登录 GitHub 官网并完成注册或登录已有账户。
2、点击右上角“+”图标,选择“New repository”。
3、在“Repository name”栏填写名称,在“Description”栏可选填写描述。
4、于“Visibility”选项中勾选“Private”,确认仓库为私有状态。
5、点击“Create repository”按钮完成创建。
二、私有仓库的协作者数量限制
免费账户创建的每个私有仓库仅支持最多3 名协作者,超出后无法再添加新成员。该限制按仓库单独计算,不影响其他仓库的协作者配置。若需扩展协作范围,必须升级至 Team 或 Enterprise 计划。
1、进入目标私有仓库页面,点击右上角“Settings”选项卡。
2、在左侧菜单中选择“Manage access”。
3、点击“Invite a collaborator”按钮,输入 GitHub 用户名。
4、当已添加 3 人后,界面将显示提示:“You've reached the limit of collaborators for this repository.”
三、单仓库存储容量硬性上限
免费账户下的每个私有仓库严格限制为500MB 总容量,该限制涵盖所有提交历史、分支、标签及对象数据库(.git 目录)的压缩后大小。一旦仓库磁盘占用超过此阈值,将无法推送新提交,且 GitHub 可能发送警告邮件要求优化。
1、在本地终端执行命令:git count-objects -vH 查看当前本地仓库对象体积。
2、访问仓库主页,点击“Insights” → “Traffic” → “Repository size” 查看 GitHub 显示的实时仓库大小。
3、若接近或超过 500MB,需执行 git filter-repo 或 BFG Repo-Cleaner 清理大文件历史。
四、大文件处理须依赖 Git LFS 且受配额约束
普通 Git 提交禁止单文件超过 100MB;若需托管大型二进制文件(如模型权重、视频素材),必须启用 Git LFS。LFS 文件本身不计入 500MB 仓库限额,但会消耗独立的免费配额:每月10 GiB 存储 + 10 GiB 带宽。超额后上传将失败,且不会自动续订。
1、在仓库根目录执行:git lfs install 初始化 LFS 支持。
2、运行:git lfs track "*.psd" 声明需追踪的文件类型。
3、执行:git add .gitattributes 提交 LFS 配置文件。
4、推送时若提示带宽超限,需等待下月重置或手动清理 LFS 对象:git lfs prune。
五、公共仓库无单库容量上限但有性能建议
免费账户创建的公共仓库虽无明确总容量封顶,但 GitHub 明确建议单仓库保持在1GB 以内以保障操作响应速度。若仓库超过 5GB,系统可能主动发送优化提示邮件,且克隆、拉取等基础操作显著变慢。此类仓库不设协作者数量限制,亦不限制 LFS 使用配额归属。
1、进入公共仓库 Settings 页面,确认 “Danger Zone” 区域未出现 “This repository is too large” 警告。
2、定期运行:git rev-list --objects --all | sort -k 2 > all_objects.txt 分析大对象分布。
3、对历史中大于 100MB 的对象,使用 git filter-repo --strip-blobs-bigger-than 100M 进行裁剪。










