概要
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 目录中。