【Windows11】WSL2 + Ubuntu 24.04 に Ruby4 を rbenvでインストールする方法

ruby -v PG工場

【Windows11】WSL2 + Ubuntu 24.04 に Ruby4 を rbenvでインストールする方法

Windows 11 上で Ruby on Rails を安定して開発するには、WSL2(Linux仮想環境)を使うのが現在のベストな方法です。
この記事では、WSL2 + Ubuntu 24.04 に Ruby 4.x を rbenv を使ってインストールする手順を、初心者向けに解説します。

1. WSL2 と Ubuntu 24.04 をインストールする

まず PowerShell(管理者)で次のコマンドを実行します。

wsl --install -d Ubuntu-24.04

インストール後に Windows を再起動します。
再起動後、「Ubuntu」というアプリが追加されていれば成功です。

Ubuntuアプリの起動画面

Ubuntu を起動すると、Linux のユーザー名とパスワードの作成を求められます。

Create a default Unix user account: sumiox
New password:
Retype new password:

このユーザー名とパスワードは、Ubuntu 内で使用する Linux のアカウントになります。


※ 重要:Ubuntu 初回起動時のユーザー名に注意

Ubuntu を初めて起動すると、

Create a default Unix user account:

と表示されます。ここで入力する名前は、

  • Rails プロジェクトの保存場所
  • Ruby や Bundler の設定
  • GitHub の SSH 鍵

など、すべての基準になる Linux のユーザー名です。

ここで seruser のような適当な名前を入れてしまうと、
後で環境を作り直す羽目になることがあります。

英小文字で、Windows や GitHub と同じ名前(例:sumiox)を入れるのがおすすめです。

2. Ubuntu を最新の状態に更新する

Ubuntu のターミナルで次を実行します。

sudo apt update
sudo apt upgrade -y

apt update 実行画面

3. Rubyのビルドに必要なツールを入れる

Rubyをソースからビルドするために、必要なパッケージをインストールします。

sudo apt install -y build-essential git curl libssl-dev libreadline-dev zlib1g-dev libyaml-dev libffi-dev libgdbm-dev libncurses5-dev libgmp-dev

パッケージインストール画面

4. rbenv をインストールする

rbenv は Ruby のバージョンを切り替えるためのツールです。

git clone https://github.com/rbenv/rbenv.git ~/.rbenv
git clone https://github.com/rbenv/ruby-build.git ~/.rbenv/plugins/ruby-build

続いて rbenv を有効化します。

echo 'export PATH="$HOME/.rbenv/bin:$PATH"' >> ~/.bashrc
echo 'eval "$(rbenv init - bash)"' >> ~/.bashrc
source ~/.bashrc

rbenv設定画面

5. Ruby 4.x をインストールする

インストール可能な Ruby の一覧を確認します。

rbenv install -l

rbenv install

最新の Ruby 4 系をインストールします(例)。

rbenv install 4.0.1
rbenv global 4.0.1

正しく入ったか確認します。

ruby -v

Ruby のバージョンが表示されれば成功です。

ruby -v

まとめ

これで Windows 11 上の WSL2 + Ubuntu 24.04 に Ruby 4.x の開発環境が構築できました。
次回は、この Ruby 環境に Rails 8 と PostgreSQL をインストールして、本格的なRails開発環境を作ります。

コメント