git push报错: remote: error: File 阿里大数据之路_笔记版本.pdf is 110.83 MB; this exceeds GitHub’s file size limit of 100.00 MB 该怎么处理
GitHub 对上传文件大小有一个限制,单个文件不能超过 100MB。如果你尝试推送超过 100MB 的文件,将会出现 remote: error: File ... exceeds GitHub's file size limit
错误。
这里有几种解决方案来处理这个问题:
1. 使用 Git Large File Storage (Git LFS)
Git LFS 是 Git 的一个扩展,专门用于处理大文件。你可以通过 Git LFS 将超过 100MB 的文件上传到 GitHub。
步骤如下:
-
安装 Git LFS:
如果你没有安装 Git LFS,首先需要安装:
-
Linux/macOS:
curl -s https://packagecloud.io/install/repositories/github/git-lfs/script.deb.sh | sudo bash sudo apt-get install git-lfs
-
Windows: 下载并安装 Git LFS。
-
-
初始化 Git LFS:
git lfs install
-
将 PDF 文件添加到 Git LFS:
git lfs track "*.pdf"
-
将
.gitattributes
文件提交到版本库:git add .gitattributes git commit -m "Track large files using Git LFS"
-
重新添加 PDF 文件并提交:
git add 阿里大数据之路_笔记版本.pdf git commit -m "Add large PDF file with Git LFS"
-
推送到远程仓库:
git push origin main
2. 删除大文件历史记录并重新提交
如果你不想使用 Git LFS 或该文件不适合版本控制,你可以删除这个大文件并将它从历史记录中清除。
-
删除大文件:
git rm --cached 阿里大数据之路_笔记版本.pdf git commit -m "Remove large PDF file"
-
使用
filter-branch
删除文件历史记录: 如果你已经提交了这个大文件,你需要从 Git 的历史记录中删除它:git filter-branch --force --index-filter 'git rm --cached --ignore-unmatch 阿里大数据之路_笔记版本.pdf' --prune-empty --tag-name-filter cat -- --all
-
推送修改并强制覆盖远程仓库:
git push origin main --force
3. 使用外部存储
如果你不想把大文件放到 Git 里,可以考虑使用外部存储服务(如 Google Drive、Dropbox 等)来存储这个文件,并将下载链接放到你的项目里。这样可以避免将大文件上传到 GitHub。
总结
- 如果你需要版本控制大文件,使用 Git LFS 是最佳方案。
- 如果文件不需要版本控制,可以通过 删除文件并清理历史记录 来解决。
- 还可以选择使用 外部存储服务 来存储大文件。