讲师中心 微信公众号

工具推荐

视频效率加速
updream

一键生成高质量推广成片

Laper
Laper

剧本策划到成片协作

AniShort
AniShort

AI短剧协同制作平台

剧云
剧云

中文短剧剧本制作平台

GitHub 仓库大小有限制吗?仓库存储与容量规则说明

秋静同学_2876

秋静同学_2876

发布时间:2026-02-21 12:09:10

|

743人浏览过

|

来源于php中文网

原创

GitHub仓库大小限制包括:普通仓库单文件≤100MB(网页上传≤25MB),公共仓建议≤1GB、超5GB触发提示,私有仓限500MB;Git LFS免费账户每月10GiB存储与带宽,单文件≤2GB;目录内文件数≤3000,推送频次建议≤6次/分钟;超限时可用git filter-repo瘦身;大文件应改用GitHub Releases或对象存储托管。

github 仓库大小有限制吗?仓库存储与容量规则说明

如果您在 GitHub 上创建或维护仓库,但发现推送失败、克隆缓慢或收到配额警告,则可能是由于仓库大小超出平台限制。以下是 GitHub 当前执行的仓库存储与容量规则说明:

一、普通仓库(非 Git LFS)的大小限制

GitHub 对普通 Git 仓库施加了明确的单文件与整体体积约束,以保障基本操作性能与服务稳定性。这些限制适用于所有免费账户,并在私有/公共仓库中差异化执行。

1、单个文件大小上限为 100 MB;若通过网页界面上传,该限制进一步收紧至 25 MB。

2、公共仓库无账户级总容量硬性封顶,但官方强烈建议单仓库保持在 1 GB 以内;超过 5 GB 将触发优化提示邮件。

3、私有仓库受更严格管控:每个私有仓库最大允许 500 MB,且不设账户级累计上限,仅按单仓计费逻辑约束。

4、磁盘上仓库总大小(含历史提交、对象数据库等)不应超过 10 GB,否则将显著拖慢克隆、提取、浏览等基础 Git 操作。

二、Git LFS 的独立配额体系

Git Large File Storage(LFS)作为大文件处理方案,其存储与带宽资源与普通仓库分离计算,启用后可规避常规仓库的 100 MB 文件拦截机制。

1、免费账户每月享有 10 GiB 存储空间 和 10 GiB 下载带宽 配额。

2、通过 LFS 追踪的单个文件最大支持 2 GB;部分资料提及上限为 5 GB,但该数值仅适用于特定企业部署场景,GitHub.com 免费层实际执行上限为 2 GB。

3、LFS 所追踪文件不计入普通仓库的 500 MB 或 1 GB 建议值,但其体积会实时扣减账户当月 LFS 配额。

4、LFS 不可用于 GitHub Pages 站点或模板仓库,且指针文件本身需符合 Git 常规文本规范。

三、目录结构与操作频率限制

除体积外,GitHub 同时对仓库内部组织方式与使用强度设限,以防止树状索引膨胀及服务过载。

1、单个目录内文件与子目录总数不得超过 3,000 个,否则将导致历史浏览与 diff 操作明显延迟。

GitHub一键发布助手(专业版)
GitHub一键发布助手(专业版)

本地项目发布到GitHub的完整工作流助手。自动执行:安全检查(.gitignore、排除敏感.env/凭据文件)、补齐开源文件(LICENSE、.gitignore)、git init/commit/branch、创建远程仓库、首次推送、可选打tag。支持git filter-repo历史敏感信息重写、force push、tag管理。Windows下走Credential Manager自动认证。触发词:"发布到GitHub"、"上传到github"、"

下载

2、每分钟向同一仓库的推送次数建议不超过 6 次;高频推送可能被临时节流或触发人工审核。

3、深度嵌套目录结构(如超过 10 层)会加剧 Git 对树对象的解析负担,官方建议采用扁平化路径划分策略。

四、历史数据清理与瘦身手段

当仓库因误提交大文件或冗余历史而超限,可通过技术干预降低其占用体积,无需升级账户类型。

1、使用 git filter-repo 或 BFG Repo-Cleaner 工具从历史提交中彻底移除指定大文件,生成精简后的提交链。

2、执行 git gc --aggressive 清理本地松散对象,并配合 git push --force-with-lease 同步瘦身结果至远程。

3、对已存在但不再需要的历史分支执行 git push origin --delete <branch-name></branch-name>,释放关联对象存储。

4、确认删除操作不可逆,所有参与协作者须重新克隆更新后的仓库,旧克隆副本将无法与新历史线合并。

五、替代性大文件分发方案

对于不适合纳入 Git 版本控制的大型资产,GitHub 明确推荐脱离 Git 体系进行托管,以规避性能与配额双重风险。

1、将数据库导出文件、视频素材、模型权重等二进制产物上传至对象存储服务(如 AWS S3、Cloudflare R2),并在 README 中提供下载链接。

2、利用 GitHub Releases 功能附加构建产物,单个 Release 可上传多个 ≤ 2 GB 的二进制附件,且不计入仓库体积统计。

3、对 CI/CD 流水线中生成的中间产物,配置缓存服务器或使用 GitHub Actions 内置缓存机制,避免反复写入仓库。

4、严禁将大型 SQL 转储文件、日志归档包、编译缓存目录纳入 Git 跟踪,此类内容应通过 .gitignore 显式排除。

热门AI工具

更多
WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

小橡皮AI

一款AI工具,主要用于小橡皮一键去AI味,将机器味重的内容改得更有活人感,防止因为 AI 内容被平台打上 AI 标签,以及限流,适合需要提升相关任务效率的用户。

VibeKnow
VibeKnow Hot

一款AI视频创作工具,主要用于全球首个AI知识视频创作平台,文档、文章、网页,一键生成视频,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

音述AI
音述AI Hot

一款AI音频处理工具,主要用于音述AI是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区,适合需要提升相关任务效率的用户。

讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

Flowith
Flowith Hot

Flowith是一款基于画布和智能体工作流的 AI 协作工作空间。

相关专题

更多
数据分析工具有哪些
数据分析工具有哪些

数据分析工具有Excel、SQL、Python、R、Tableau、Power BI、SAS、SPSS和MATLAB等。详细介绍:1、Excel,具有强大的计算和数据处理功能;2、SQL,可以进行数据查询、过滤、排序、聚合等操作;3、Python,拥有丰富的数据分析库;4、R,拥有丰富的统计分析库和图形库;5、Tableau,提供了直观易用的用户界面等等。

5063

2023.10.12

SQL中distinct的用法
SQL中distinct的用法

SQL中distinct的语法是“SELECT DISTINCT column1, column2,...,FROM table_name;”。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

1031

2023.10.27

SQL中months_between使用方法
SQL中months_between使用方法

在SQL中,MONTHS_BETWEEN 是一个常见的函数,用于计算两个日期之间的月份差。想了解更多SQL的相关内容,可以阅读本专题下面的文章。

1329

2024.02.23

SQL出现5120错误解决方法
SQL出现5120错误解决方法

SQL Server错误5120是由于没有足够的权限来访问或操作指定的数据库或文件引起的。想了解更多sql错误的相关内容,可以阅读本专题下面的文章。

7141

2024.03.06

sql procedure语法错误解决方法
sql procedure语法错误解决方法

sql procedure语法错误解决办法:1、仔细检查错误消息;2、检查语法规则;3、检查括号和引号;4、检查变量和参数;5、检查关键字和函数;6、逐步调试;7、参考文档和示例。想了解更多语法错误的相关内容,可以阅读本专题下面的文章。

3783

2024.03.06

oracle数据库运行sql方法
oracle数据库运行sql方法

运行sql步骤包括:打开sql plus工具并连接到数据库。在提示符下输入sql语句。按enter键运行该语句。查看结果,错误消息或退出sql plus。想了解更多oracle数据库的相关内容,可以阅读本专题下面的文章。

7140

2024.04.07

sql中where的含义
sql中where的含义

sql中where子句用于从表中过滤数据,它基于指定条件选择特定的行。想了解更多where的相关内容,可以阅读本专题下面的文章。

10001

2024.04.29

sql中删除表的语句是什么
sql中删除表的语句是什么

sql中用于删除表的语句是drop table。语法为drop table table_name;该语句将永久删除指定表的表和数据。想了解更多sql的相关内容,可以阅读本专题下面的文章。

1370

2024.04.29

Go-Zero API开发使用教程
Go-Zero API开发使用教程

本专题聚焦Go-Zero的API开发,拆解.api描述文件的语法结构、路由与分组定义、参数绑定与校验规则,说明统一响应体、JWT鉴权、跨域与接口文档生成的落地方式,并给出网关聚合与接口测试的实践建议。

140

2026.11.12

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Postman Native Git工作流指南
Postman Native Git工作流指南

共0课时 | 0人学习

vscode手册
vscode手册

共0课时 | 0人学习

Git 教程
Git 教程

共21课时 | 8.2万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn