大文件上传GitHub失败解决

发布时间:2026/5/19 10:51:00

大文件上传GitHub失败解决 GitHub 的限制单次推送大小限制GitHub 对单个推送的数据包大小有限制通常 2GB 左右但网络超时更常见。单个文件大小建议≤ 100 MB超过 100 MB 会警告超过 2 GB 会被拒绝。仓库总大小建议 ≤ 1 GB免费账户限制更严。方案一拆分提交减少单次推送大小如果大文件是多个小文件可以分批提交推送。方案二使用Git LFS将大文件如数据集、二进制文件用 Git LFS 管理绕过传统推送限制。下载链接https://git-lfs.github.com/1、在仓库中启用LFSgit lfs install2、跟踪大文件类型1) 根据你的文件类型输入# 例如 git lfs track *.zip git lfs track *.tar.gz git lfs track *.bin git lfs track *.h5 git lfs track *.npy2) 然后提交.gitattributesgit add .gitattributes git commit -m 启用 Git LFS 跟踪大文件3、重新添加并推送文件git add . git commit -m 使用 LFS 上传大文件 git push origin upload-branchGit LFS 是一次性配置Git LFS 的配置是仓库级别的一旦配置好后续所有推送都会自动应用。配置包括在仓库中安装 LFS 钩子git lfs install通常在全局执行一次指定要跟踪的文件类型通过.gitattributes文件将 LFS 跟踪规则提交到仓库之后每次git add、git commit、git pushGit LFS 都会自动处理被跟踪的大文件。需要重新配置LFS的情况新克隆的仓库如果仓库已包含.gitattributes和 LFS 规则你只需运行一次git lfs pull下载大文件不需要重新配置跟踪规则。添加新的文件类型如果之前没跟踪某种大文件类型比如现在要添加.mp4需要在.gitattributes中添加新规则重新提交。在新电脑上需要先安装 Git LFS 并运行git lfs install一次。

相关新闻