☰
Git Push 大文件推送失败及解决方案
2026/11/4 19:14:54 网站建设 项目流程

Git Push 大文件推送失败及解决方案

git push : remote: fatal: pack exceeds maximum allowed size (2.00 GiB) error: remote unpack failed: index-pack failed38 MiB/s To github.com: xxx

你在执行git push命令时遇到了核心报错:远程仓库检测到打包后的文件体积超过了 2.00 GiB 的上限,导致推送失败(index-pack failed)。这个问题的本质是GitHub 服务器端对单次推送的 pack 包大小设置了 2GB 硬限制,本地调整打包配置无法绕过这个限制。

解决方案(优先推荐 Git LFS)

GitHub 官方推荐使用Git LFS(Large File Storage)来管理大文件(超过 100MB 的文件都建议用 LFS),这是解决大文件推送限制的标准方案,步骤如下:

1. 安装 Git LFS

根据你的操作系统执行对应命令:

# Mac(Homebrew)brewi

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询