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

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）
brew i