gem

RubyGems 包管理器

补充说明

gem 安装、查询和发布 Ruby 包（gem）。它管理全局或用户级 gem，项目级依赖应交给 Bundler，避免环境之间互相污染。

常用示例

gem install rails
gem install rails -v 7.2.0
gem install --user-install rails
gem list
gem update
gem uninstall rails
gem env
gem sources
gem which rails
gem contents rails
gem build mygem.gemspec
gem push mygem-1.0.0.gem

易错点与排错

• 系统目录安装需要 root；用 --user-install 后要确认 ~/.local/share/gem/ruby/*/bin 在 PATH。
• 全局 gem 和 Bundler 管理的 gem 是两套环境；命令行工具优先 bundle exec。
• gem update 可能一次升级大量包；生产环境锁定版本。
• 原生扩展安装失败通常是缺少编译工具或系统库；看 gem install 的 mkmf 输出。
• 多个 Ruby 版本各有独立 gem 目录；换版本后旧 gem 不一定可用。
• 私有源和认证不要写进仓库；用凭据文件或环境变量。
• gem sources --add 要确认 HTTPS 和证书；镜像可能在同步上滞后。

相关命令

• bundle — 项目依赖
• ruby — 解释器