概要

rbenv <命令> [<参数>…​]

说明

rbenv 尊重项目目录中的 .ruby-version 文件,确保自动调用针对该项目配置的 Ruby 版本,从而调用任何 **ruby**、**gem**、**bundle** 或其他 Ruby 命令调用。

它通过为所有 Ruby 可执行文件生成垫片来实现。只要 rbenv 垫片目录前置到 PATH,rbenv 即自动确保在 Ruby 版本之间透明切换。

rbenv 在 $RBENV_ROOT/versions 目录中查找可用的 Ruby 版本。

命令

rbenv global [<版本>]

查看或更改全局 Ruby 版本

rbenv local [<版本>]

查看或更改本地 Ruby 版本

rbenv shell [<版本>]

查看或更改当前 shell 会话的 Ruby 版本

rbenv version

查看当前活动的 Ruby 版本及设置位置

rbenv versions

列出 rbenv 已知的全部已本地安装的 Ruby 版本

rbenv install [<版本>]

(由 ruby-build 插件提供) 下载并安装新的 Ruby 版本

rbenv rehash

重新生成所有已知 Ruby 可执行文件的垫片

rbenv which [<命令>]

查看命令解析到的可执行路径

rbenv init

帮助自举将 rbenv 引入当前 shell 环境

rbenv help [<命令>]

查看任何 rbenv 命令的帮助文本

环境变量

RBENV_VERSION (默认值:从 .ruby-version 文件读取)

要使用的 Ruby 版本名称

RBENV_ROOT (默认值:~/.rbenv)

rbenv 发现 Ruby 版本、插件和其他配置所在的位置

RBENV_DEBUG

激活关于 rbenv 内部标准错误信息的调试信息打印

RBENV_HOOK_PATH

冒号分隔的路径列表,用于搜索 rbenv 插件脚本

RBENV_DIR (默认值:$PWD)

自下而上遍历的目录,以找到 .ruby-version 文件

插件

作为其核心功能,rbenv 只能在 Ruby 版本之间切换,其他什么也不做,但是提供了插件机制来衔接和覆盖其默认行为的几乎所有方面。

rbenv 最常见的插件是 ruby-build,它有助于将新的 Ruby 版本安装到 $RBENV_ROOT/versions 目录中。

备注