GitHub文件过大怎么处理？拆分与LFS使用教程

当GitHub提示“file too large”时，别慌——这通常只是触达了100MB单文件限制的警报，而本文直击痛点，为你提供三套即学即用的实战方案：用Git LFS智能托管大文件，让仓库轻盈如初；手动拆分超限文件为合规子块，兼容所有Git环境；或借助git filter-repo彻底清理历史中“幽灵般”的大文件，拯救克隆速度与推送体验——无论你是刚踩坑的新手，还是被遗留问题困扰的维护者，这里都有清晰、可靠、经验证的解决路径。

如果您尝试将大文件上传到 GitHub 仓库，但收到“file too large”错误提示，则可能是由于 GitHub 对单个文件大小限制为 100 MB，且推荐上限为 50 MB。以下是解决此问题的步骤：

一、使用 Git LFS 替代常规 Git 跟踪大文件

Git LFS（Large File Storage）通过将大文件内容存储在远程服务器上，仅在本地仓库保留轻量级指针文件，从而绕过 GitHub 的单文件大小限制。

1、在项目根目录执行命令安装并初始化 Git LFS：git lfs install。

2、声明需由 LFS 管理的文件类型，例如所有 ZIP 文件：git lfs track "*.zip"。

3、将生成的 .gitattributes 文件加入暂存区：git add .gitattributes。

4、添加目标大文件（如 large_data.zip）：git add large_data.zip。

5、提交并推送：git commit -m "Add large file via LFS"，随后执行 git push origin main。

二、手动拆分大文件后分别上传

对不可用 LFS 的场景（如私有 Git 服务器不支持 LFS），可将单个超限文件分割为多个符合 GitHub 限制的子文件，再统一提交。

1、在 Linux/macOS 终端中，使用 split 命令将 500 MB 的 video.mp4 拆分为每份 95 MB 的块：split -b 95M video.mp4 video_part_。

2、确认生成的文件均小于 100 MB：ls -lh video_part_*。

3、将所有分片文件加入 Git：git add video_part_*。

4、提交并推送：git commit -m "Split and upload video files"，然后运行 git push origin main。

三、使用 git filter-repo 清理历史中已误传的大文件

若大文件已被提交至历史记录，即使后续删除，仍会保留在 Git 对象库中，导致克隆缓慢或推送失败；需彻底从历史中移除该文件的全部版本。

1、安装 git-filter-repo 工具（如未安装）：pip install git-filter-repo。

2、克隆裸仓库副本以保障安全操作：git clone --mirror https://github.com/user/repo.git。

3、进入仓库目录，执行清理命令（以删除所有 *.psd 文件为例）：git filter-repo --path-glob "*.psd" --invert-paths。

4、强制推送重写后的历史到远程：git push origin --force --all 和 git push origin --force --tags。

好了，本文到此结束，带大家了解了《GitHub文件过大怎么处理？拆分与LFS使用教程》，希望本文对你有所帮助！关注golang学习网公众号，给大家分享更多文章知识！