雁过留声 发表于 2025-2-17 12:07:52

保姆级GitHub大文件(100mb-2gb)上传教程

GLF(Git Large File Storage)安装使用

使用GitHub desktop上传大于100mb的文件时报错

 The following files are over 100MB. lf you commit these files, you will no longer be
 able to push this repository to GitHub.com.
 term.rar
 We recommend you avoid committing these files or use Git LFS to store large files on
 GitHub. Windows:可以从 Git LFS 下载并安装Git Large File Storage


https://i-blog.csdnimg.cn/img_convert/4f6ed148700ee4da01779cd0c8429cae.png
安装成功

https://i-blog.csdnimg.cn/img_convert/f29941481ece30921e8c23b4825b0952.png

如何确认是否当地安装Git LFS 成功


https://i-blog.csdnimg.cn/img_convert/2fb7525f7706b3a5d5c8c06a929d04a3.png
详细操作过程:


https://i-blog.csdnimg.cn/img_convert/8f6f69ac98f5c1ea2459236a9f7ccaa0.png
下面是详细的后续步骤,每一步都会标明是在当地操作照旧在 GitHub 上验证的。

当地仓库指与github中远程连接的仓库,本文不再赘述
【当地操作】


[*] 打开命令行工具 使用 Git Bash、CMD 或 PowerShell 打开终端,并切换到你仓库所在的目录。例如:
 cd C:\path\to\your\repository
[*] 初始化 Git LFS 在仓库目录下运行以下命令,确保 Git LFS 被初始化:
 git lfs install 此步骤会配置 Git LFS 钩子,确保后续对大文件的处理精确。
[*] 告诉 Git LFS 跟踪大文件 运行以下命令,指定需要用 Git LFS 管理的文件(此处以 .rar 文件为例):
 git lfs track "Al.rar" 执行后,会在仓库根目录天生一个名为 .gitattributes 的文件,此中包罗雷同下面的内容:
 Al.rar filter=lfs diff=lfs merge=lfs -text
[*] 添加并提交 .gitattributes 文件 将 .gitattributes 文件添加到暂存区并提交,这样其他协作者在克隆仓库时也会得到 Git LFS 的跟踪设置:
 git add .gitattributes
 git commit -m "Track large files with Git LFS"
[*] 添加并提交大文件 接下来,将大文件添加到 Git 仓库并提交。留意,假如文件名中包罗特殊字符(如括号),可以用转义符或直接使用引号:
 git add "Al.rar"
 git commit -m "Add large file via Git LFS"
[*] 推送到 GitHub 将所有当地更改推送到远程 GitHub 仓库。Git LFS 会将大文件上传到专门的存储地区:
 git push origin <branch-name> 请将 <branch-name> 更换为你实际使用的分支名称(例如 main 或 master)。

【在 GitHub 上的验证】


[*] 验证文件是否由 Git LFS 管理

[*] 登录 GitHub 后,进入你的仓库页面。
[*] 浏览对应文件(Al.rar)的详情页面,GitHub 会表现该文件由 Git LFS 管理的信息。
[*] 另外,你可以在仓库的 "Insights" 或 "Settings" 中查察 Git LFS 的使用环境和统计数据,确认大文件已经精确上传。

[*] 查抄提交记载 在 GitHub 的 "Commits" 页面查察你的提交记载,确保提交中包罗了 .gitattributes 和大文件提交。大文件的提交内容应该是一个指向实际数据的 LFS 指针,而非完备的二进制数据。

报错

  Size must be less than or equal to 2147483648: Size must be less than or equal to 2147483648
 error: failed to push some refs to “” Size must be less than or equal to 2147483648


[*] 此中 2147483648 字节等于 2GB。这意味着单个 Git LFS 管理的文件大小必须小于或等于 2GB。
[*] HTTP 状态码 422: 错误信息中的 是 HTTP 状态码,表现“Unprocessable Entity”(无法处理的实体),即服务器吸收到了请求,但请求中的某个部分(这里是文件大小)不符合要求。

办理方案:

拆分成多个小文件,或者进一步压缩以低落文件大小。于超过 2GB 的文件,GitHub 及 Git LFS 并不适合直接托管。这时可以思量使用云存储服务(如 Google Drive 等),然后在仓库中放置链接或说明。

免责声明:如果侵犯了您的权益,请联系站长,我们会及时删除侵权内容,谢谢合作!更多信息从访问主页:qidao123.com:ToB企服之家,中国第一个企服评测及商务社交产业平台。
页: [1]
查看完整版本: 保姆级GitHub大文件(100mb-2gb)上传教程