rbenv

Ruby 版本管理器

补充说明

rbenv 通过 shim 切换多个 Ruby 版本，安装功能由 ruby-build 插件提供。它只管理解释器；gem 依赖仍由 Bundler 管理。

常用示例

rbenv install --list
rbenv install 3.3.5
rbenv versions
rbenv global 3.3.5
rbenv local 3.3.5
rbenv shell 3.3.5
rbenv version
rbenv which ruby
rbenv rehash
rbenv init

易错点与排错

• rbenv install 需要 ruby-build 插件；没有插件时只能 rbenv versions。
• shim 目录必须在 PATH 前面；否则系统 Ruby 会优先执行。
• 安装新版本或新 gem 后可执行 rbenv rehash；命令找不到先试这个。
• 优先级是 shell > local > global；用 rbenv version 确认实际来源。
• rbenv init 要写入 shell 配置；不初始化不会自动切换。
• 编译 Ruby 需要 openssl、readline、yaml 等开发库；失败时看构建日志。
• gem install 装到当前 Ruby 的目录；切版本后 gem 不共享。
• 与 rvm、asdf 混用会争抢 PATH 和 shim；只保留一种。

相关命令

• ruby — 解释器
• gem / bundle — 依赖管理
• pyenv — Python 版本管理