rbenv 使用指南

8 条评论 , 31 次修正,106865 次阅读,最后更新于 2020年10月09日

这篇简单介绍 rbenv 的安装和使用。如果可以请直接看作者的文档:

https://github.com/rbenv/rbenv

rbenv 用来管理多个版本的 ruby 在用户目录的安装和使用,和 rvm 二选一使用。具体区别 rbenv 的文档里有说明,社区里也有讨论。

系统需求

OSX: 请找一个网好的地方,从 app store 里下载 xcode.app, 安装完成后运行,在设置中的 Downloads 里安装 Command Line Tools.

Linux: 请安装开发环境 (编译链接工具和 ruby 的依赖), 如果只要 jruby 有 jre 就可以了。

安装 rbenv

在 osx 上可以直接用 homebrew 安装,下面是手动安装过程。 (不用 zsh 的童鞋注意替换成自己的 shell 配置文件)

git clone https://github.com/rbenv/rbenv.git ~/.rbenv
# 用来编译安装 ruby
git clone https://github.com/rbenv/ruby-build.git ~/.rbenv/plugins/ruby-build
# 用来管理 gemset, 可选, 因为有 bundler 也没什么必要
git clone git://github.com/jamis/rbenv-gemset.git  ~/.rbenv/plugins/rbenv-gemset
# 通过 rbenv update 命令来更新 rbenv 以及所有插件, 推荐
git clone git://github.com/rkh/rbenv-update.git ~/.rbenv/plugins/rbenv-update
# 使用 Ruby China 的镜像安装 Ruby, 国内用户推荐
git clone git://github.com/AndorChen/rbenv-china-mirror.git ~/.rbenv/plugins/rbenv-china-mirror

然后把下面的代码放到 ~/.bash_profile

export PATH="$HOME/.rbenv/bin:$PATH"
eval "$(rbenv init -)"
export RUBY_BUILD_MIRROR_URL=https://cache.ruby-china.com

注意 Unubtu 请放到 ~/.bashrc 里,zsh 用户是 ~/.zshrc

然后重开一个终端就可以执行 rbenv 了。

使用

安装 ruby

rbenv install --list  # 列出所有 ruby 版本
rbenv install 1.9.3-p392     # 安装 1.9.3-p392
rbenv install jruby-1.7.3    # 安装 jruby-1.7.3

列出版本

rbenv versions               # 列出安装的版本
rbenv version                # 列出正在使用的版本

设置版本

rbenv global 1.9.3-p392      # 默认使用 1.9.3-p392
rbenv shell 1.9.3-p392       # 当前的 shell 使用 1.9.3-p392, 会设置一个 `RBENV_VERSION` 环境变量
rbenv local jruby-1.7.3      # 当前目录使用 jruby-1.7.3, 会生成一个 `.rbenv-version` 文件

解决 MacOSX 下编译 Ruby 无法在 irb 中输入中文的方法

安装 homebrew 的 readline,再进入源码目录,重新编译安装 readline.bundle

brew install readline
brew link readline
cd src/ruby-1.9.3-p392/ext/readline
ruby extconf.rb --with-readline-dir=$(brew --prefix readline)
make install

rbenv 下的解决办法

brew install readline
CONFIGURE_OPTS="--disable-install-doc --with-readline-dir=$(brew --prefix readline)" rbenv install 1.9.3-p392

有关 ruby-2.0.0-p0 在 OS X 10.7+ 上的问题,参见:https://github.com/rbenv/ruby-build/wiki

其他

rbenv rehash                 # 每当切换 ruby 版本和执行 bundle install 之后必须执行这个命令
rbenv which irb              # 列出 irb 这个命令的完整路径
rbenv whence irb             # 列出包含 irb 这个命令的版本

rbenv 下使用 gemset

简介

rvm 中最方便的就是 gemset。实际上,rbenv 通过插件也可以使用 gemset

安装

MacOS 下使用 brew 的话,一个命令就搞定

brew install rbenv-gemset

使用

创建一个 gemset

rbenv gemset create 1.9.3-p392 ruby-china
                       参数 1       参数 2
  • 以上命令中,参数 1 是已安装的 ruby 版本,参数 2 是 gemset 的名字

具体使用方法

  1. 在项目的根目录下,把想要使用的 gemset 名字放到 .rbenv-gemsets 文件中即可。有 .rbenv-gemsets 文件的情况下执行 bundle 命令就是对设置好的 gemset 进行操作
echo ruby-china > .rbenv-gemsets
  1. 当前目录下没有 .rbenv-gemsets 文件的情况下,执行 bundle 命令(没有指定 --path 参数的情况)时,是对当前版本的 ruby 版本的 gemset。也就相当于 rvm 中 global gemset 的作用了

参考

其他

还是请看 rbenv 的文档