【问题记录】解决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
相关推荐
掘金安东尼34 分钟前
蔚来 600 亿研发成本,信还是不信。。
面试·程序员·github
喜欢吃豆1 小时前
深入企业内部的MCP知识(三):FastMCP工具转换(Tool Transformation)全解析:从适配到增强的工具进化指南
java·前端·人工智能·大模型·github·mcp
赋范大模型技术社区2 小时前
【LangChain 实战】多智能体协作实现浏览器自动化丨Agents 运行流程丨多工具串&并联调用
架构·github·代码规范
T - mars2 小时前
Git在Pycharm中的使用
git
sunarmy3 小时前
curl: (56) OpenSSL SSL_read: Connection reset by peer, errno 104
git
liangdabiao4 小时前
3分钟打造一个无敌的落地页Landing Page - 任何内容都完全自动化
程序员·github
典学长编程4 小时前
高效学习之一篇搞定分布式管理系统Git !
大数据·git·搜索引擎
是2的10次方啊5 小时前
.gitignore失效自救指南:原理揭秘与工程师实战排查全流程
git
海外空间恒创科技5 小时前
香港站群服务器与普通香港服务器对比
服务器·git·github
JinSo6 小时前
EasyEditor AI 聊天助手:让低代码开发更简单
前端·javascript·github