bundle

Bundler 项目依赖管理

补充说明

bundle（Bundler）按 Gemfile 安装和锁定 Ruby 依赖，生成 Gemfile.lock。项目内的命令应通过 bundle exec 运行，确保使用锁定版本。

常用示例

bundle init
bundle install
bundle install --path vendor/bundle
bundle install --deployment
bundle exec rspec
bundle exec rails server
bundle update
bundle add rack
bundle remove rack
bundle list
bundle info rails
bundle check
bundle lock --add-platform x86_64-linux
bundle config set --local path vendor/bundle
bundle clean

易错点与排错

• bundle install 用 lockfile 的版本；bundle update 才会升级，二者不要混用。
• Gemfile.lock 必须提交；不同平台可能需要 bundle lock --add-platform。
• bundle exec 保证加载锁定版本；直接运行 rspec 可能用到全局 gem。
• --path vendor/bundle 会改变安装位置；CI 缓存和 .gitignore 要同步调整。
• 部署用 --deployment/--frozen 防止意外更新 lockfile。
• 原生扩展依赖系统库；Alpine 等精简镜像要装构建依赖。
• bundle clean 会删除未使用的 gem；确认没有其他项目共享同一路径。
• 私有源认证写在 Bundler 配置或环境变量，不要提交凭据。

相关命令

• gem — 全局包管理
• ruby — 解释器