大文件上传GitHub失败解决

GitHub 的限制

• 单次推送大小限制：GitHub 对单个推送的数据包大小有限制（通常 2GB 左右），但网络超时更常见。

• 单个文件大小：建议≤ 100 MB，超过 100 MB 会警告，超过 2 GB 会被拒绝。

• 仓库总大小：建议 ≤ 1 GB，免费账户限制更严。

方案一：拆分提交（减少单次推送大小）

如果大文件是多个小文件，可以分批提交推送。

方案二：使用Git LFS

将大文件（如数据集、二进制文件）用 Git LFS 管理，绕过传统推送限制。

下载链接：https://git-lfs.github.com/

1、在仓库中启用LFS

git lfs install

2、跟踪大文件类型

1) 根据你的文件类型输入：

# 例如： git lfs track "*.zip" git lfs track "*.tar.gz" git lfs track "*.bin" git lfs track "*.h5" git lfs track "*.npy"

2) 然后，提交.gitattributes：

git add .gitattributes git commit -m "启用 Git LFS 跟踪大文件"

3、重新添加并推送文件

git add . git commit -m "使用 LFS 上传大文件" git push origin upload-branch

Git LFS 是一次性配置

Git LFS 的配置是仓库级别的，一旦配置好，后续所有推送都会自动应用。配置包括：

1. 在仓库中安装 LFS 钩子（git lfs install通常在全局执行一次）

2. 指定要跟踪的文件类型（通过.gitattributes文件）

3. 将 LFS 跟踪规则提交到仓库

之后每次git add、git commit、git push，Git LFS 都会自动处理被跟踪的大文件。

需要重新配置LFS的情况

1. 新克隆的仓库：如果仓库已包含.gitattributes和 LFS 规则，你只需运行一次git lfs pull下载大文件，不需要重新配置跟踪规则。

2. 添加新的文件类型：如果之前没跟踪某种大文件类型（比如现在要添加.mp4），需要在.gitattributes中添加新规则，重新提交。

3. 在新电脑上：需要先安装 Git LFS 并运行git lfs install一次。