在 Ruby 开发的世界中，经常需要面对不同项目使用不同 Ruby 版本的情况。这时，一个高效、灵活且易于使用的 Ruby 版本管理工具就显得尤为重要。
rbenv 正是这样一个工具，它允许开发者在同一台计算机上轻松安装、切换和管理多个 Ruby 版本。本文将详细介绍 rbenv 的安装、基本使用以及一些高级特性，帮助你更好地掌握这个强大的工具。
rbenv 是一个轻量级的 Ruby 版本管理工具，通过修改环境变量来控制当前使用的 Ruby 版本。它不会干扰系统自带的 Ruby 环境，而是为用户提供一个隔离的 Ruby 运行环境。这意味着你可以根据项目需求，轻松切换到所需的 Ruby 版本，确保项目的兼容性和运行稳定性。
在 macOS (或 Linux) 系统上，建议使用 Homebrew 安装 rbenv。详细教程
brew install rbenv ruby-build
Homebrew 详细教程可查看：
在 shell 中加载 rbenv
运行下面命令，并按照打印的说明进行操作：
rbenv init
例如，下面这个示例，我们运行 rbenv init 后，提示将 eval "$(rbenv init - zsh)" 添加到 ~/.zshrc 文件中，才能自动加载 rbenv。
$ rbenv init
# Load rbenv automatically by appending
# the following to ~/.zshrc:
eval "$(rbenv init - zsh)"
执行 source ~/.zshrc 或者关闭终端窗口并打开一个新窗口，让我们的更改生效。
对于更自动化的安装，可以使用 rbenv-installer。如果更喜欢手动方法安装，请按照以下步骤操作。
将 rbenv 克隆到 ~/.rbenv:
git clone https://github.com/rbenv/rbenv.git ~/.rbenv
配置 shell 来加载 rbenv: 详细教程
对于 bash:
在 macOS (或 Linux) 系统上，bash 通常通过以下方式配置 ~/.bash_profile:
echo 'eval "$(~/.rbenv/bin/rbenv init - bash)"' >> ~/.bash_profile
对于 Zsh:
echo 'eval "$(~/.rbenv/bin/rbenv init - zsh)"' >> ~/.zshrc
如果你好奇，请查看此处以了解 init 的作用。
执行 source ~/.zshrc 或者关闭终端窗口并打开一个新窗口，让我们的更改生效。
rbenv 的简单性使得临时禁用或从系统中卸载它变得很容易。详细教程
要禁用 rbenv 管理你的 Ruby 版本，只需从 shell 启动配置中注释或删除 rbenv init 行即可。这将从 PATH 中删除 rbenv shims 目录，并且将以后的使用（例如 ruby）将执行系统版本 Ruby，完全绕过 rbenv。
禁用后，rbenv 仍可在命令行上访问，但你的 Ruby 应用程序不会受到版本切换的影响。
要完全卸载 rbenv，请执行步骤(1)，然后删除 rbenv 根目录。这将删除安装在 `rbenv root`/versions/ 下的所有 Ruby 版本：
rm -rf "$(rbenv root)"
如果你已使用包管理器安装了 rbenv，则最后一步执行 rbenv 包删除：
brew uninstall rbenvsudo apt purge rbenvsudo pacman -R rbenvrbenv install 命令不随 rbenv 一起提供，而是由 ruby-build 插件提供。
在尝试安装 Ruby 之前，请检查你的构建环境是否具有必要的工具和库。然后：
rbenv install -l # 列出最新的稳定版本
rbenv install -L # 列出所有本地版本
rbenv install 3.3.0 # 安装 Ruby 版本
要对 BUILD FAILED 场景进行故障排除，请查看 ruby-build 讨论部分。
如果
rbenv install命令找不到，你可以将 ruby-build 作为插件安装：git clone https://github.com/rbenv/ruby-build.git "$(rbenv root)"/plugins/ruby-build
安装完后，需要设置 Ruby 版本以完成安装并开始使用 Ruby，你可以使用 rbenv versions 命令查看已安装的版本列表。要切换/设置到特定版本，请运行：
rbenv global 3.3.0 # 设置本机的默认 Ruby 版本，你可以替换为你已安装的版本号
# 或:
rbenv local 3.3.0 # 设置该目录的 Ruby 版本，你可以替换为你已安装的版本号
# 或:
rbenv shell 3.3.0 # shell 环境，切换到 Ruby 3.3.0 版本，你可以替换为你已安装的版本号
除了 rbenv install 命令之外，你还可以手动下载并编译 Ruby 作为 ~/.rbenv/versions 的子目录。该目录中的内容也可以是安装在文件系统其他位置的 Ruby 版本的符号链接。
例如，使用 rbenv local 3.3.0 为你的项目选择 Ruby 版本。然后，像平常一样继续安装 gems：
gem install bundler
你不应该使用
sudo来安装 gem。通常，Ruby 版本将安装在你的主目录下，因此你的用户可以写入。如果你在安装 gems 时收到“你没有写入权限”错误，则很可能你的“系统” Ruby 版本仍然是全局默认版本。使用rbenv global <version>更改它，然后重试。
使用 gem env 检查 gem 的安装位置：
gem env home
# => ~/.rbenv/versions/<version>/lib/ruby/gems/...
随着时间的推移，你安装的 Ruby 版本将累积在 ~/.rbenv/versions 目录中。
要删除旧的 Ruby 版本，只需 rm -rf 你要删除的版本的目录即可。你可以使用 rbenv prefix 命令查找特定 Ruby 版本的目录，例如 rbenv prefix 3.3.0。
ruby-build 插件提供了 rbenv uninstall 命令来自动执行删除过程。
rbenv uninstall 3.3.0 # 自动执行删除 Ruby 版本
你需要了解的主要 rbenv 命令是。详细教程
列出 rbenv 已知的所有 Ruby 版本，并在当前活动版本旁边显示一个星号。
$ rbenv versions
system
2.7.4
* 3.3.0 (set by /Users/liam/.rbenv/version)
jruby-9.4.6.0
mruby-3.3.0
truffleruby-24.0.1
显示当前活动的 Ruby 版本，以及有关其设置方式的信息。
$ rbenv version
3.3.0 (set by /Users/liam/.rbenv/version)
通过将版本名称写入当前目录中的 .ruby-version 文件来设置本地应用程序特定的 Ruby 版本。此版本覆盖全局版本，并且可以通过设置 RBENV_VERSION 环境变量或使用 rbenv shell 命令来覆盖自身。
rbenv local 3.1.2
当不带版本号运行时，rbenv local 会报告当前配置的本地版本。你还可以取消设置本地版本：
rbenv local --unset
通过将版本名称写入 ~/.rbenv/version 文件来设置要在所有 shell 中使用的 Ruby 全局版本。此版本可以通过特定于应用程序的 .ruby-version 文件或通过设置 RBENV_VERSION 环境变量来覆盖。
rbenv global 3.1.2
特殊版本名称 system 告诉 rbenv 使用系统 Ruby（通过搜索 $PATH 来检测）。
当没有版本号运行时，rbenv global 报告当前配置的全局版本。
通过在 shell 中设置 RBENV_VERSION 环境变量来设置特定于 shell 的 Ruby 版本。此版本覆盖特定于应用程序的版本和全局版本。
rbenv shell jruby-9.4.6.0
当没有版本号运行时，rbenv shell 会报告 RBENV_VERSION 的当前值。你还可以取消设置 shell 版本：
rbenv shell --unset
请注意，你需要启用 rbenv 的 shell 集成（安装说明的步骤 3）才能使用此命令。如果你不想使用 shell 集成，你可以简单地自己设置
RBENV_VERSION变量：export RBENV_VERSION=jruby-9.4.6.0
为 rbenv 已知的所有 Ruby 可执行文件安装 shims (~/.rbenv/versions/*/bin/*)。通常你不需要运行此命令，因为它会在安装 gems 后自动运行。
rbenv rehash
显示给定可执行文件的，的完整路径。
$ rbenv which irb
/Users/liam/.rbenv/versions/3.3.0/bin/irb
列出包含指定可执行文件名称的所有 Ruby 版本。
$ rbenv whence rackup
3.3.0
jruby-9.4.6.0
truffleruby-24.0.1
| 名称 | 默认 | 描述 |
|---|---|---|
RBENV_VERSION |
指定要使用的 Ruby 版本。另请参阅 rbenv shell |
|
RBENV_ROOT |
~/.rbenv |
定义 Ruby 版本和 shims 所在的目录。另请参阅 rbenv root |
RBENV_DEBUG |
输出调试信息。例如：rbenv --debug <subcommand> |
|
RBENV_HOOK_PATH |
查看 wiki | 搜索 rbenv hooks 查看路径列表 |
RBENV_DIR |
$PWD |
开始搜索 .ruby-version 文件的目录 |
rbenv 还支持通过插件来扩展功能。例如，ruby-build 和 rbenv-vars 插件可以让你更方便地安装和管理 Ruby 版本。你可以通过 Homebrew 或直接从 Git 仓库安装这些插件，并使用它们来简化 Ruby 版本的安装和管理过程。
安装 ruby-build 插件的命令如下。详细教程
# 通过 Homebrew 安装
brew install ruby-build
# 或者通过 Git 安装
git clone https://github.com/rbenv/ruby-build.git "$(rbenv root)"/plugins/ruby-build
安装完成后，你可以使用 ruby-build 命令来安装和管理 Ruby 版本，而无需手动下载和编译 Ruby 源代码。
安装 rbenv-vars 插件的命令如下。详细教程
# 通过 Homebrew 安装
brew install rbenv-vars
# 或者通过 Git 安装
git clone https://github.com/rbenv/rbenv-vars.git "$(rbenv root)"/plugins/rbenv-vars
安装完成后，你可以使用 ruby-vars 命令让你在生成 Ruby 进程之前设置全局和特定于项目的环境变量。
rbenv 是一个功能强大的 Ruby 版本管理工具，它允许开发者在同一台计算机上轻松安装、切换和管理多个 Ruby 版本。通过使用 rbenv，你可以确保你的项目在正确的 Ruby 环境中运行，从而提高开发效率和代码质量。
随着 Ruby 生态系统的不断发展，rbenv 将继续成为开发者不可或缺的工具之一。希望本文能帮助你更好地理解和使用 rbenv，为你的 Ruby 开发之旅提供便利！
访问博址 liam-i.github.io 获取更佳阅读体验和最新内容。