提交至GitLab时提示Git blob过大的问题求助

一、定位大文件（即使git ls-tree查不到路径） #

如果git ls-tree -r HEAD | grep $BLOB_ID没返回结果，用下面的命令精准定位：

• 通过Blob ID直接找对应文件路径：git rev-list --objects --all | grep $BLOB_ID
• 列出仓库所有历史中的大文件（按大小排序）：git verify-pack -v .git/objects/pack/*.idx | sort -k 3 -n，找到最大的Blob ID后，再用上面的命令关联到具体文件。

二、彻底清除历史中的大文件 #

推荐用git filter-repo（比旧工具更稳定） #

1. 先安装git filter-repo，用包管理器直接装：
   • macOS：brew install git-filter-repo
   • Linux：sudo apt install git-filter-repo
2. 移除指定大文件，把<大文件路径>换成你找到的路径：

   git filter-repo --path <大文件路径> --invert-paths
   

3. 强制推送到远程仓库（注意：这会覆盖远程历史，确保团队成员同步操作）：

   git push origin --force --all
   git push origin --force --tags
   

备选：用git filter-branch（旧方法，部分场景适用） #

如果没法装git filter-repo，用这个命令：

git filter-branch --force --index-filter 'git rm --cached --ignore-unmatch <大文件路径>' --prune-empty --tag-name-filter cat -- --all

执行完同样强制推送。

三、避免再踩坑的预防措施 #

• 确认.gitignore里已经加了node_modules/，执行git rm -r --cached node_modules后提交一次，确保忽略规则生效
• 用git check-ignore node_modules/验证忽略规则是否正常工作
• 前端项目尽量不要追踪大文件，真有需要再考虑GitLab LFS（大文件存储）

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