Contents
1. 公式ダウンロードページと最新版の確認方法
Ruby 本体の公式配布は以下の URL から行われます。
- 公式ダウンロードページ
https://www.ruby-lang.org/ja/downloads/
このページでは次が確認できます。
| 項目 | 内容 |
|---|---|
| 最新版(安定版) | 「Ruby X.Y.Z」 として表示。リリースノートへのリンクも同時に提供されます。 |
| ソース tar.gz | ruby-X.Y.Z.tar.gz がダウンロード可能。 |
| 各プラットフォーム向けバイナリ | Windows 用 RubyInstaller、macOS 用 Homebrew の formula 名などが記載されています(※Homebrew の formula は公式ページではなく Homebrew のリポジトリで確認)。 |
ポイント
- 「Ruby 4.0 系」の正式リリースがまだの場合は、ページ上に「開発版」や「プレビュー」情報として掲載されることがあります。実運用で使用する際は必ず「安定版(Stable)」かどうかを確認してください。
2. Linux 系ディストリビューションでのインストール
2‑1. パッケージマネージャによる導入(現行パッケージ)
多くの主要ディストリビューションは、公式リポジトリに Ruby の安定版 を提供しています。2026 年春時点で各ディストリビューションが配布しているバージョンは以下の通りです(※日付やリポジトリ更新により変動します)。
| ディストリビューション | 推奨コマンド例 | 提供パッケージ名 |
|---|---|---|
| Ubuntu / Debian | sudo apt update && sudo apt install ruby-full |
ruby, ruby-full |
| Fedora | sudo dnf install ruby |
ruby |
| openSUSE | sudo zypper install ruby |
ruby |
| Arch Linux | sudo pacman -Sy ruby |
ruby |
注意点
- 公式リポジトリは 最新安定版(例: Ruby 3.2 系)までしか追随しないことが多く、Ruby 4 系が未格納の場合があります。
- バージョンを明示したパッケージ名(
ruby4.0やruby-4.0等)は現在の公式リポジトリには存在しません。
対策:最新版が必要な場合は、次節で紹介する
rbenv/ruby-buildもしくはソースビルドを利用してください。
2‑2. rbenv + ruby-build を用いた最新版インストール
(1) 必要パッケージの事前インストール(Ubuntu の例)
|
1 2 3 4 5 |
sudo apt update sudo apt install -y build-essential libssl-dev libreadline-dev zlib1g-dev \ libyaml-dev libsqlite3-dev sqlite3 libgdbm-dev libncurses5-dev \ libffi-dev autoconf bison git curl |
他ディストリビューション
- Fedora:sudo dnf groupinstall "Development Tools"で基本ツールを、sudo dnf install openssl-devel readline-devel zlib-devel libyaml-devel sqlite-devel gdbm-devel ncurses-devel ffi-devel bison autoconfでライブラリをインストール。
- Arch:sudo pacman -S base-devel openssl readline zlib yaml sqlite gdbm ncurses ffi bison autoconf git curl
(2) rbenv と ruby-build の取得
|
1 2 3 4 5 6 7 8 9 10 11 12 |
# rbenv 本体のクローン git clone https://github.com/rbenv/rbenv.git ~/.rbenv cd ~/.rbenv && src/configure && make -C src # シェルにパスを追加(~/.bashrc, ~/.zshrc など共通) echo 'export PATH="$HOME/.rbenv/bin:$PATH"' >> ~/.bashrc echo 'eval "$(rbenv init -)"' >> ~/.bashrc source ~/.bashrc # ruby-build プラグインの取得 git clone https://github.com/rbenv/ruby-build.git ~/.rbenv/plugins/ruby-build |
(3) 最新版 Ruby のビルドと設定
|
1 2 3 4 5 6 7 8 9 10 11 12 |
# 利用可能なバージョン一覧を取得(例: 4.0 系が表示されれば OK) rbenv install -l | grep '^ 4\.0' # 目的のバージョンをインストール(リストに無い場合はソースビルド参照) rbenv install 4.0.2 # ← バージョンが正式に提供されていることが前提 # デフォルトバージョンに設定 rbenv global 4.0.2 # 動作確認 ruby -v # => ruby 4.0.2pXX (2026-??-??) [x86_64-linux] |
ポイント
ruby-buildは公式リポジトリに未掲載のバージョンでも自動でビルド定義を取得します。
ビルド中にエラーが出た場合は、欠損している開発ヘッダーやライブラリを追加インストールしてください。
2‑3. RVM(Ruby Version Manager)の利用
RVM は Ruby 本体だけでなく gemset 機能を提供し、プロジェクト単位の依存管理が容易です。以下は Ubuntu 系 OS の手順です。
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 |
# GPG 鍵取得とインストールスクリプト実行 gpg --keyserver hkp://pool.sks-keyservers.net --recv-keys \ 409B6B1796C275462A1703113804BB82D39DC0E3 \ 7D2BAF1CF37B13E2069D6956105BD0E739499BDB \curl -sSL https://get.rvm.io | bash -s stable # シェルに RVM をロード source ~/.rvm/scripts/rvm # 必要な依存パッケージのインストール(RVM が自動提示) rvm requirements # Ruby 4.0.2 のインストールとデフォルト設定 rvm install 4.0.2 rvm use 4.0.2 --default # バージョン確認 ruby -v # => ruby 4.0.2pXX ... |
gemset の例
|
1 2 3 4 5 |
cd my_project rvm gemset create myproject_gems rvm gemset use myproject_gems bundle install # Gemfile があれば依存をインストール |
RVM と rbenv の比較ポイント
- rbenv はシンプルで軽量、ruby-buildで新バージョン取得が容易。
- RVM は gemset が標準装備されている点で大規模プロジェクトに有利。
3. macOS でのインストール
3‑1. Homebrew が提供する Ruby(現行版)
Homebrew の公式 formula は 最新版(執筆時点では Ruby 3.2 系) を提供します。Ruby 4 系が正式にリリースされた場合は、ruby@4 といった名前で追加される可能性がありますが、まだ存在しないことが多いため、以下の手順で 現行安定版 を取得してください。
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 |
# Homebrew 本体とパッケージ情報の更新 /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" brew update # Ruby(最新版)をインストール brew install ruby # → /opt/homebrew/opt/ruby へ配置(Apple Silicon の例) # パスを通す(zsh, bash 共通) echo 'export PATH="/opt/homebrew/opt/ruby/bin:$PATH"' >> ~/.zshrc source ~/.zshrc # バージョン確認 ruby -v # => ruby 3.2.xpXX (2026-??-??) [arm64-darwin20] |
補足
brew info rubyで提供されているバージョンとインストールパスを随時確認できます。
Ruby 4 系が formula に追加されたら、brew install ruby@4やbrew install ruby@4.0といった名前になる可能性があります(公式リポジトリでの命名規則に従います)。
3‑2. rbenv + ruby-build と Homebrew の併用
Homebrew が提供するビルドツール類を活用しつつ、最新版 Ruby を管理したい場合は次の手順が便利です。
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 |
# 必要ツールのインストール(Xcode Command Line Tools は別途実行) brew install rbenv ruby-build # シェル設定に追記 echo 'eval "$(rbenv init -)"' >> ~/.zshrc source ~/.zshrc # OpenSSL のパスを明示(Homebrew 版 openssl@3 が推奨) brew install openssl@3 export RUBY_CONFIGURE_OPTS="--with-openssl-dir=$(brew --prefix openssl@3)" # Ruby 4.0.2 をインストール(公式リポジトリに存在すれば実行可能) rbenv install 4.0.2 rbenv global 4.0.2 ruby -v # => ruby 4.0.2pXX (2026-??-??) [arm64-darwin20] |
ポイント
*RUBY_CONFIGURE_OPTSに OpenSSL のパスを設定しないと、ビルド時に「openssl not found」エラーが出やすいです。
3‑3. RVM のインストール(macOS)
|
1 2 3 4 5 6 |
\curl -sSL https://get.rvm.io | bash -s stable --ruby=4.0.2 source ~/.rvm/scripts/rvm # インストール完了確認 ruby -v # => ruby 4.0.2pXX ... |
注意
RVM のインストーラはデフォルトで最新版 Ruby を取得しようとしますが、対象バージョンがリポジトリに無い場合はエラーになるため、先にrbenv/ruby-buildでビルドしたものを手動で指定する方法もあります。
4. Windows でのインストール
4‑1. RubyInstaller(公式)からの取得手順
Windows 向けの公式配布は RubyInstaller が提供します。2026 年現在、公式サイトに掲載されている最新版は Ruby 3.x 系が中心です。Ruby 4 系がリリースされた場合でも、同様のページ構成で提供されます。
-
ダウンロードページへアクセス
https://rubyinstaller.org/downloads/ (「RubyInstaller for Windows」セクション) -
対象バージョンを選択
- 例:
Ruby+Devkit 4.0.2-1 (x64)のインストーラ(ファイル名はrubyinstaller-4.0.2-x64.exe) -
x86 が必要な場合は
rubyinstaller-4.0.2-x86.exeを選択。 -
インストール実行
- 「Add Ruby executables to your PATH」に必ずチェック。
- 画面の指示に従い、MSYS2 Development Toolchain のインストールも同時に行う(最初のインストール後に別ウィンドウで自動実行されます)。
重要ポイント
* インストーラはC:\Ruby40などのデフォルトディレクトリへ展開します。インストール先を変更した場合は、後述の PATH 設定に合わせてください。
4‑2. 環境変数 PATH の手動設定と確認
自動設定が失敗したケースやカスタムディレクトリにインストールした場合は、以下手順で PATH を追加します。
- システム環境変数画面を開く
-
「設定」 → 「システム」 → 「バージョン情報」 → 「関連設定」 → 「システム情報」 → 「詳細設定」 → 「環境変数」。
-
Pathに Ruby のbinディレクトリを追加 -
例:
C:\Ruby40\bin(インストール先に合わせて変更)。 -
PowerShell/コマンドプロンプトで確認
|
1 2 3 4 5 6 |
> ruby -v ruby 4.0.2pXX (2026-??-??) [x64-mingw32] > where ruby # パスが正しく通っているかをチェック C:\Ruby40\bin\ruby.exe |
エラーが出た場合は、where ruby の結果と環境変数の設定を再度照合してください。
5. ソースコードからのビルド手順
公式サイトから取得した tar.gz を自分でコンパイルする方法です。最新版がリポジトリに無い場合や、カスタム設定(例:インストール先ディレクトリ変更)を行いたいときに有効です。
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 |
# 1. ソース取得(URL は公式キャッシュの最新パス) curl -L https://cache.ruby-lang.org/pub/ruby/4.0/ruby-4.0.2.tar.gz -o ruby-4.0.2.tar.gz # 2. 解凍・ディレクトリ移動 tar -xzf ruby-4.0.2.tar.gz cd ruby-4.0.2 # 3. 必要パッケージのインストール(Ubuntu の例) sudo apt update sudo apt install -y build-essential libssl-dev libreadline-dev zlib1g-dev \ libyaml-dev libsqlite3-dev sqlite3 libgdbm-dev libncurses5-dev \ libffi-dev bison autoconf # 4. ビルド設定(インストール先は /opt/ruby-4.0.2 とする例) ./configure --prefix=/opt/ruby-4.0.2 --enable-shared \ --with-openssl-dir=$(brew --prefix openssl@3 2>/dev/null || echo "/usr") # 5. コンパイル & インストール make -j$(nproc) sudo make install # 6. PATH に追加(シェル設定ファイルへ追記) echo 'export PATH="/opt/ruby-4.0.2/bin:$PATH"' >> ~/.bashrc source ~/.bashrc # 7. バージョン確認 ruby -v # => ruby 4.0.2pXX (2026-??-??) [x86_64-linux] |
トラブルシューティング
./configureが失敗したら、エラーログに記載されている「missing library」や「header not found」を手掛かりに追加パッケージをインストールしてください。
ビルド後にldd $(which ruby)でリンク先ライブラリが正しく解決できているか確認できます。
6. 複数バージョン管理と切り替え方法
6‑1. rbenv によるバージョン切替
|
1 2 3 4 5 6 7 8 9 10 11 12 13 |
# 例)4.0.2 と 3.2.2 を同時にインストール rbenv install 4.0.2 rbenv install 3.2.2 # デフォルト(global)を 4.0.2 に設定 rbenv global 4.0.2 # プロジェクトごとにローカルバージョン指定 cd legacy_project rbenv local 3.2.2 # .ruby-version が作成される ruby -v # → 現在のディレクトリで有効なバージョンが表示 |
rbenv rehash を忘れずに実行すれば、インストールした gem の実行ファイルも正しくパスに反映されます。
6‑2. RVM によるバージョン・gemset 切替
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 |
# バージョン一覧取得とインストール rvm list known | grep '^ 4\.0' rvm install 4.0.2 rvm install 3.2.2 # デフォルトに設定 rvm use 4.0.2 --default # プロジェクトごとの gemset 作成と切替 cd new_project rvm gemset create newproj_gems rvm use 4.0.2@newproj_gems # バージョン+gemset の同時指定 ruby -v # → ruby 4.0.2pXX ... gem list # → 当該 gemset にインストールされたものだけが表示される |
RVM は rvm use コマンドで バージョン + gemset の組み合わせを一括指定でき、CI 環境でもスクリプト化しやすい点が特徴です。
7. インストール確認・簡単サンプル
7‑1. 基本的なコマンドでの動作検証
|
1 2 3 4 5 6 7 8 |
$ ruby -v ruby 4.0.2pXX (2026-??-??) [x86_64-linux] $ irb irb(main):001:0> puts "Hello, Ruby!" Hello, Ruby! => nil |
7‑2. 「Hello, World」プログラムの実行
|
1 2 3 |
# hello.rb puts "Hello, World" |
端末で次を実行:
|
1 2 3 |
$ ruby hello.rb Hello, World |
上記が期待通りに出力されれば、Ruby 本体・PATH の設定・標準ライブラリは正常に機能しています。
8. まとめと次のステップ
| 項目 | 推奨手段 |
|---|---|
| 安定版(公式リポジトリ) | apt, dnf, brew 等、OS が提供するパッケージマネージャでインストール。 |
| 最新版・未対応バージョン | rbenv + ruby-build または RVM でソースビルドを自動化。 |
| Windows 環境 | RubyInstaller(公式)+ PATH 設定。 |
| 複数バージョン共存 | rbenv(シンプル)か RVM(gemset 有り)で管理。 |
| カスタムビルドが必要なとき | ソース取得 → ./configure → make → make install の手順を実行。 |
次に挑戦したいこと
- Bundler と Rails のセットアップ
bash
gem install bundler
gem install rails - CI/CD 環境への Ruby バージョン導入(GitHub Actions, GitLab CI など)。
rbenvのインストールスクリプトを.ymlに組み込むだけで完了します。
最終的な注意点
- 本稿のコマンドは「2026‑04 時点」の情報に合わせています。リポジトリやパッケージ名が変更された場合は、公式サイト・GitHub リポジトリを必ず確認してください。
- 企業内で利用する際は、セキュリティポリシー(署名付きバイナリの検証等)に従い、インストール手順をレビューしましょう。
この記事は、読者が 安全かつ確実に Ruby を導入できるよう 作成しました。質問や不明点があれば、公式フォーラムや Stack Overflow で検索・投稿してください。