【问题记录】解决Git上传文件到GitHub时收到 “GH001: Large files detected” 错误信息!

环境

问题情况

  • 在命令行中使用git上传pdf文件到GitHub服务器时,提示了如下警告信息:
  • 原因是 GitHub 有一个文件大小限制,通常为 100 MB。
    • 如果尝试上传大于此限制的文件,GitHub 将拒绝接受这个文件。
    • 如果上传大于50MB,小于100MB,GitHub则会提示警告信息,但不影响上传。

解决方法

  • 怎么解决呢?,命令行中也提示我们了,它说让我们去尝试使用 "Git大文件存储",也就是推荐我们去使用 Git LFS。
  • Git Large File Storage(LFS)是 Git 的一个扩展,允许将大文件存储在单独的存储库中,并将其链接到主存储库。这样可以避免大文件占用主存储库的空间。如果使用 Git LFS,我们就可以将大文件上传到 LFS 存储库,然后在主存储库中链接到它们。

安装流程

  • 打开 Git Large File Storage (LFS) 网页,下载该插件。

  • 下载并安装Git命令行扩展,然后开始按以下步骤进行配置了(就是官网的 Getting Started 教程)。

  • 运行以下命令为你的用户帐户设置Git LFS(每个用户帐户只需运行一次即可):
    *

    复制代码
    git lfs install
  • 在每个想要使用Git LFS的Git存储库中(就是切换到要上传大文件所在的Git存储库目录下),选择希望Git LFS管理的文件类型(或直接编辑.gitattributes)。也可以随时配置其它文件扩展名。(我这里是pdf文件)
    *

    复制代码
    git lfs track "*.pdf"
  • 然后确保 .gitattributes 文件被跟踪:
    *

    复制代码
    git add .gitattributes
  • 注意,定义Git LFS应该跟踪的文件类型本身不会将任何先前存在的文件转换为Git LFS,例如其它分支上的文件或先前提交历史中的文件。要做到这一点,可以使用 git lfs migrate(1) 命令,该命令提供了一系列适合各种潜在用例的选项。

  • 最后执行以下三步,只需提交并推送到GitHub(如果当前的分支名为main):

    • git add fileName.pdf
    • git commit -m "Add a large file"
    • git push origin main
相关推荐
wuk9983 小时前
基于MATLAB编制的锂离子电池伪二维模型
linux·windows·github
ai小鬼头4 小时前
AIStarter如何助力用户与创作者?Stable Diffusion一键管理教程!
后端·架构·github
天天扭码5 小时前
从图片到语音:我是如何用两大模型API打造沉浸式英语学习工具的
前端·人工智能·github
&Sinnt&7 小时前
Git 版本控制完全指南:从入门到精通
git·后端
独立开阀者_FwtCoder7 小时前
【Augment】 Augment技巧之 Rewrite Prompt(重写提示) 有神奇的魔法
前端·javascript·github
极客悟道9 小时前
巧解 Docker 镜像拉取难题:无需梯子和服务器,拉取数量无限制
后端·github
Tiny2149 小时前
多人协同开发时Git使用命令
git
独立开阀者_FwtCoder10 小时前
你用 Cursor 写公司的代码安全吗?
前端·javascript·github
WebGirl10 小时前
代码Revert后再次Merge会丢失的问题
git
T__TIII11 小时前
Dify 自定义插件
人工智能·github