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

  • Windows 11 家庭中文版
  • git version 2.41.0.windows.1
  • GitHub

  • 在命令行中使用git上传pdf文件到GitHub服务器时,提示了如下警告信息:【问题记录】解决Git上传文件到GitHub时收到 “GH001: Large files detected” 错误信息!_第1张图片
  • 原因是 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上传文件到GitHub时收到 “GH001: Large files detected” 错误信息!_第2张图片
  • 下载并安装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

你可能感兴趣的:(问题记录,git,github)