如何下载Git LFS配额超限的GitHub仓库内容解决问题

按以下流程操作即可在不付费的前提下取回所有文件，不需要依赖第三方工具：

• 绕过LFS拉取限制克隆仓库元数据
  克隆时添加环境变量跳过LFS自动拉取流程，不会触发配额校验：

  GIT_LFS_SKIP_SMUDGE=1 git clone 你的仓库地址
  

  执行完成后仓库会完整克隆到本地，只是所有被LFS追踪的文件都是几百字节的指针文件（存储对应文件的哈希、大小元数据），不会出现之前的smudge报错。
• 导出全量LFS文件清单
  进入仓库根目录，执行命令导出所有LFS文件的路径、对应哈希值：

  git lfs ls-files -l > lfs_manifest.txt
  

  导出的清单每行格式为<文件SHA256哈希> * <文件在仓库内的相对路径>，可以作为后续下载、还原的索引。
• 下载实际文件内容
  登录GitHub账号后，在网页端进入对应LFS文件的详情页，直接点击页面上的Download按钮即可下载真实文件——配额超限只会封禁Git LFS的批量API拉取通道，网页端单文件下载通道不会被完全锁死。如果文件数量较多，可以基于导出的清单，携带自己账号的登录Cookie写简单脚本批量请求下载，不会出现之前的Cookie校验失败、422报错问题。
• 本地还原仓库
  将下载好的文件按清单里的相对路径放到仓库对应位置，执行git lfs checkout即可完成文件校验和还原，拿到完整的仓库内容。

如果后续要彻底移除LFS避免再触发配额问题，拿到所有文件后执行以下操作即可：

# 将所有LFS指针替换为实际文件，重写提交历史
git lfs migrate export --everything --include="*"
# 删除.gitattributes里的LFS追踪规则
# 强制推送重写后的历史到远程仓库
git push --force

操作完成后远程仓库不再占用Git LFS配额，后续正常使用Git即可。

• 网络上流传的curl方案失败，核心是请求没有携带你登录GitHub后的有效Cookie和CSRF校验token，GitHub对匿名/校验信息不全的LFS请求会直接拦截，和配额无关。
• 旧的Python拉取脚本报错是因为工具长期未更新，适配的是多年前旧版Git LFS的输出格式，新版Git LFS返回的属性行结构变化导致解析失败，不是配额问题导致的。
• 直接git clone报错是因为默认配置下克隆完成后会自动触发LFS批量拉取流程，触发了配额限制中断checkout，实际上Git仓库的元数据已经全部拉取到本地，并非克隆完全失败。

内容的提问来源于stack exchange，提问作者Csaba Toth