Rubyの複数バージョンを管理するツール。

rbenv は ~/.rbenv/shims をPATHに追加して ruby コマンドを ~/.rbenv/shims/ruby に置き換える。この ruby コマンドの実体はシェルスクリプトで rbenv で選択したバージョンの ruby を呼び出している。

rbenv自体にはRubyをインストール機能がない。自前でビルドしても良いが ruby-build というプラグインを入れるのが普通。

ruby-buildをインストールするとinstall/uninstallサブコマンドが使えるようになる。

インストール可能なRubyのバージョン一覧

$ rbenv install --list 

2.0.0-p0をインストール

$ rbenv install 2.0.0-p0

MacOSXの場合XCodeに付属のgcc（llvm-gcc）ではRubyをビルドできない事がある。homebrewでgccをインストールしてビルド時に指定すると良い

$ brew install gcc48
$ CC=/usr/local/bin/gcc-4.8 rbenv install 1.8.7-p249

2.0.0-p0ではopensslを独自にビルドするのでopensslを別途インストール不要。ただしbrewでインストールしたものを指定したい場合は、

$ RUBY_CONFIGURE_OPTS="--with-openssl-dir=$(brew --prefix openssl)" rbenv install 2.0.0-p0

いくつかバージョンを指定する方法がある。

shell設定を行うと、現在のシェルセッションで使うrubyを指定できる。この設定は最も優先度が高い。Rubyで書かれたアプリを本番環境でデーモンとして起動するのに使うと良い。

$ rbenv shell 2.0.0-p2

この設定は環境変数RBENV_VERSIONに保存される。

local設定を行うと、カレントディレクトリ以下の階層にいるときに指定のバージョンのrubyが使用される。Rubyアプリ開発に使うと便利。

$ rbenv local 1.9.3-p194
$ ruby -v 
ruby 1.9.3p194 (2012-04-20 revision 35410) [x86_64-darwin10.8.0]

local 設定は .rbenv-version というファイルに記録される。

local 設定が見つからない場合は、global 設定が使われる。普段使うバージョンを指定すると良い。

$ rbenv global 2.0.0-p0 

global 設定は ~/.rbenv/version に記録される