github单文件限制100mb，解决方法有三：一、用git lfs跟踪大文件，执行git lfs install、track、add .gitattributes及文件后提交推送；二、手动拆分大文件为≤95mb子文件再上传；三、用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。
