はじめに
Ubuntuを使っている(もしくはWSL)向けに、Rubyの仮想環境rbenvを用いた環境構築手順をメモします。
RubyはPythonを扱うときと同じように、仮想環境を活用して管理すると便利です。
構築環境
OS: Ubuntu 24.04 LTS
Ruby: 3.2.8
仮想環境: rbenv
Rails: 8.x 系想定
sudo apt install ruby を直接行わないほうが環境構築不可能にならなくていいです。
構築手順
1. 依存ライブラリのインストール
Ruby を ソースビルドするので必須になります。
sudo apt update
sudo apt install -y \
build-essential \
libssl-dev \
libreadline-dev \
zlib1g-dev \
libyaml-dev \
libffi-dev \
libxml2-dev \
libxslt1-dev \
libicu-dev \
git curl
2. rbenv をインストール（apt版）
sudo apt install -y rbenv
シェル初期化（bash）
echo 'export PATH="$HOME/.rbenv/bin:$PATH"' >> ~/.bashrc
echo 'eval "$(rbenv init -)"' >> ~/.bashrc
source ~/.bashrc
確認：
rbenv --version
3. ruby-build を使う
公式版を rbenv plugin として導入：
git clone https://github.com/rbenv/ruby-build.git ~/.rbenv/plugins/ruby-build
4. Ruby をインストール
rbenv install 3.2.8
成功すると：
Installed ruby-3.2.8 to ~/.rbenv/versions/3.2.8
5. プロジェクトごとに Ruby を固定
cd [your_project]
rbenv local 3.2.8
.ruby-version が生成されます。
確認：
ruby -v
which ruby
- bundler をインストール
gem install bundler
rbenv rehash
確認：
which bundle
~/.rbenv/shims/bundle
7. bundle install
bundle install
gem はすべて、
~/.rbenv/versions/3.2.8/lib/ruby/gems/...
に入ります。
よくあるエラーと対処
- apt 版 ruby-build を使っている
-> gitからクローンしましょう。
まとめ
上記のような手順でrbenvを用いてRubyの仮想環境を構築し、バージョンの管理をすると簡単にできて、便利かと思います。