GitHub如何上传大于25MB的文件

前言

利用Git上传代码,当大于25MB的文件时,会提示上传失败,此时需要使用Git LFS(Git Large File)来上传大文件。Git安装可参考Git的安装步骤

1 下载安装Git LFS

1.1 下载Git LFS

Git LFS 下载链接:https://github.com/git-lfs/git-lfs/releases

1.2 安装Git LFS

下载完成后,双击安装包,按照提示进行安装即可。

2.使用Git LFS

2.1 初始化并推送单个文件

进入我的项目文件夹路径C:\Users\tang xingyou\MyGithub\GRACE_GMT_scripts,打开Git Bash,输入以下命令:

初始化仓库并安装LFS应用

1
2
3
4
5
git init
git lfs install
git lfs track *
git add .gitattributes

添加属性文件上传的说明:

1
git commit -m ".gitattributes commit"

建立本地和 Github 仓库的链接(origin 后接自己仓库的链接)

1
git remote add origin https://github.com/SingyuTang/GRACE_GMT_scripts.git

上传文件,推送到远程分支,远程仓库默认分支是 main,因此这里为main分支(可以使用git branch命令查看当前分支

1
git push -u origin main

注意,推送前可以使用git ls-remote --heads origin查看远程仓库分支,如果显示的是其他分支(如 master),需要推送到对应分支:

1
git push origin master

或者将远程分支名称更改为 main(推荐)再推送:

1
git push origin main

如果当前分支名称不是main,可使用命令git branch -M main将当前分支重命名为 main,并强制执行(如果目标分支名已经存在,将会覆盖它)。实际操作步骤如下:

1
2
3
4
5
6
查看当前分支
git branch
如果当前分支名称不是 main,可以使用以下命令重命名
git branch -M main
如果远程仓库使用的是 main 分支,重命名本地分支后,需要更新远程的分支关联
git push --set-upstream origin main

2.2 推送全部文件

1
2
3
git add *
git commit -m "Git LFS commit"
git push origin main

2.3 其它配置

1
2
3
4
5
6
7
8
9
10
11
12
13
设置为 0 表示关闭低速检测,Git 不会因传输速度过低而中断连接
git config --global http.lowSpeedLimit 0
设置为 99999 表示允许长时间的低速传输
git config --global http.lowSpeedTime 99999
支持更大的数据块传输
git config --global http.postBuffer 157286400
清除当前远程仓库(origin)的代理设置,确保 Git 直接通过本地网络连接到远程仓库
git config --global --add remote.origin.proxy ""
指定使用 OpenSSL 作为 Git 的 SSL 后端,用于处理 HTTPS 请求的加密通信,更稳定
git config --global http.sslBackend "openssl"
禁用 SSL 证书验证,忽略 HTTPS 请求中的证书检查。这样可以绕过证书相关的问题
git config --global http.sslVerify false

参考文档

GitHub 上传大文件(>25 MB)教程(推荐)

CSDN-GitHub上传大于25M的文件


GitHub如何上传大于25MB的文件
https://singyutang.github.io/2025/01/05/GitHub如何上传大于25MB的文件/
作者
SingyuTang
发布于
2025年1月5日
许可协议