Rails项目Ruby Bundler报错：Git文件超GitHub大小限制求解决

数据老陈

2026-6-30

修复Bundler缓存文件超GitHub 100MB限制的方法

彻底清理本地Bundler缓存
直接删除整个vendor/bundle目录，避免残留大文件：
```
rm -rf vendor/bundle
```
之后重新安装依赖，建议用非部署模式避免生成冗余缓存：
```
bundle install --no-deployment
```
完善.gitignore规则
确保.gitignore里明确排除Bundler相关缓存目录，添加以下内容：
```
/vendor/bundle/
/.bundle/
```
如果之前已经把这些目录提交到Git，要从暂存区移除并提交变更：
```
git rm -r --cached vendor/bundle
git commit -m "移除已缓存的Bundler vendor文件"
```
安装依赖时跳过缓存
执行安装命令时加上--no-cache选项，避免生成大体积的Git pack缓存文件：
```
bundle install --no-cache
```
清理Git历史中的大文件（若已提交）
如果大文件已经被提交到Git历史，用git filter-repo彻底移除（注意：此操作会改写历史，团队协作需提前同步）：
```
git filter-repo --path vendor/bundle/ruby/3.3.0+0/cache/bundler/git/rails-fcf0202857b07db1a0f6220dae5ca99319ca0f32/objects/pack/pack-263ebbefd14ff7251d902b8eaee2d784646f38ee.pack --invert-paths
```
之后强制推送到远程仓库（替换main为你的分支名）：
```
git push origin main --force
```
调整Bundler路径配置
可以指定Bundler使用非Git跟踪的目录存放依赖，比如：
```
bundle config set path '~/.bundle/local'
```
这样依赖文件会存到用户目录下，不会被Git捕获。