GitHub Desktop 本地提交与远程推送的文件大小限制是多少？

本地仓库提交限制 #

GitHub Desktop 本身没有对本地提交的文件大小做额外限制，这一步的约束仅来自你本地设备的存储容量以及原生 Git 的性能表现：

• 单文件体积在 GB 级别时虽然可以正常提交，但会大幅拉长本地提交的耗时，也会降低后续仓库操作（切换分支、查看历史提交等）的运行效率。

GitHub 远程仓库推送限制 #

推送的大小限制是 GitHub 平台的通用规则，和你是否使用 GitHub Desktop 没有关联，具体规则如下：

• 单文件体积超过 50MB 时，推送过程会触发官方的警告提示
• 单文件体积超过 100MB 时，推送请求会被直接拦截，无法成功上传
• 普通公开/私有仓库的建议总容量不超过 1GB，仓库总占用超过 5GB 时会收到平台的容量预警，严重超容可能会被限制推送权限。

超限解决方案 #

如果你的文件不符合上述限制，可以提前调整方案：

• 单文件过大的场景，可采用 Git LFS 管理大文件，它会将大文件实体存在独立存储区，仓库内仅保留轻量指针，可绕过普通 Git 的文件大小限制
• 总文件量过大的场景，可将不同业务的文件拆分到多个独立仓库，或者提前过滤掉不需要提交的临时文件、构建产物、依赖包等内容后再提交。

内容的提问来源于stack exchange，提问作者alexpro_23