Contents
Windows で Ruby を導入する手順(Ruby 4 系列を対象にした最新情報)
※2026‑05‑05 時点の情報です
現在、Ruby 本家は Ruby 4.0.3 の正式リリースをアナウンスしていません。バージョンが将来公開された際に同様の手順で導入できるよう、本稿では「公式サイトに掲載されている Ruby 4 系列(例: 4.0.3)」が存在したと仮定した流れをまとめました。実際にインストールする場合は、必ず公式リリースページでバージョン・日付を確認してください。
1. リリース情報の確認方法
| 手順 | 操作内容 | ポイント |
|---|---|---|
| ① | https://www.ruby-lang.org/ja/downloads/releases/ を開く | 「Release」一覧に対象バージョン(例: Ruby 4.0.3)が掲載されているか確認 |
| ② | バージョン行のリンクをクリックし、リリースノートを読む | リリース日・変更点・既知の不具合が明示されていれば正式版と判断できる |
注意
- 「開発版(preview / RC)」や「ベータ」表記がある場合は、本番環境での使用は自己責任となります。
- 公式サイト以外のミラー配布はハッシュ値検証ができないことが多く、安全性が保証されません。
2. Windows 用インストーラの取得先とファイル名
| 配布元 | 推奨理由 | 実際に入手できるファイル例 |
|---|---|---|
| RubyInstaller(公式) | MSYS2 ベースの開発環境を自動構築し、PATH 追加まで行う。Windows 向けに最も広く利用されている。 | rubyinstaller-devkit-4.0.3-x64.exe(※バージョン番号は対象リリースに合わせて変わります) |
| Microsoft Store | GUI で簡単インストール、定期的な自動更新が可能。ただし DevKit が同梱されない点に留意。 | Ruby アプリ(パッケージ名は 9NBLGGH4R315 等) |
| winget | コマンド一発でインストールでき、スクリプト化が容易。内部的には RubyInstaller を呼び出す仕組み。 | winget install RubyInstallerTeam.Ruby |
| Scoop | バージョン切り替えや複数インスタンスの管理に強い。MSYS2 は手動で導入する必要がある場合あり。 | scoop bucket add extras → scoop install ruby |
2‑1. RubyInstaller の取得手順(推奨)
- 上記公式サイト(https://rubyinstaller.org/)の Downloads ページへアクセス
- 「Ruby 4.x (x64) – RubyInstaller‑DevKit」セクションから対象バージョンを選択
- ダウンロードしたファイルの SHA256 ハッシュがページ下部に記載されているので、以下コマンドで照合
|
1 2 |
certutil -hashfile rubyinstaller-devkit-4.0.3-x64.exe SHA256 |
ハッシュが一致しない場合はダウンロードをやり直すか、公式サイト以外から取得した可能性があります。
3. インストール手順(GUI ウィザード版)
インストール先のデフォルトパス はバージョンに合わせて
C:\Ruby40x系列が推奨されます(例:C:\Ruby403). 必要に応じて変更してください。
| 手順 | 操作内容 |
|---|---|
| 1 | ダウンロードした rubyinstaller-devkit-4.0.3-x64.exe を 右クリック → 管理者として実行 |
| 2 | ライセンス条項に同意し Next |
| 3 | 「インストール先」画面でデフォルト (C:\Ruby403) または任意のディレクトリを指定し Next |
| 4 | 「MSYS2 の自動インストール」にチェック(既定でオン)し Install をクリック |
| 5 | インストール完了後、表示される「Run ridk install」ボタンを押して必須ツールチェーンを取得 |
| 6 | 「Add Ruby to PATH」のチェックが入っていることを確認し、Finish |
3‑1. コマンドラインでインストーラ実行(無人化スクリプト例)
|
1 2 |
rubyinstaller-devkit-4.0.3-x64.exe /verysilent /dir="C:\Ruby403" /tasks=ridk,addtopath |
/verysilent… 進捗バーのみ表示、ユーザー操作不要/dir=… インストール先を明示(デフォルトはC:\Ruby403)/tasks=… 後続の MSYS2 自動インストール (ridk) と PATH 追加 (addtopath) を同時実行
4. winget / scoop による CLI インストール例
| ツール | コマンド | 補足 |
|---|---|---|
| winget | winget install RubyInstallerTeam.Ruby --exact --silent |
--exact はパッケージ名の完全一致、--silent で無人インストール。内部的に上記 GUI インストーラを呼び出すので、MSYS2 と PATH が自動設定されます。 |
| scoop | powershell<br>scoop bucket add extras<br>scoop install ruby@4.0.3<br> |
ruby バケットは「extras」内にあり、バージョン指定が可能。インストール後に手動で ridk install を実行し MSYS2 をセットアップしてください。 |
5. インストール後の環境確認
5‑1. PATH が正しく通っているか
|
1 2 3 |
C:\> echo %PATH% ...;C:\Ruby403\bin;C:\msys64\usr\bin;... |
C:\Ruby403\binとC:\msys64\usr\bin(MSYS2 のパス)が含まれていれば OK。- 含まれていない場合は「システム環境変数」→「Path」から手動で追加し、再起動または
setx PATH "%PATH%;C:\Ruby403\bin"を実行。
5‑2. Ruby と Gem のバージョン確認
|
1 2 3 4 5 6 |
C:\> ruby -v ruby 4.0.3p0 (2026-04-02 revision abcdef) [x64-mingw-ucrt] C:\> gem -v 4.0.3 |
出力が上記のようになれば、実行ファイル・ライブラリ共に正しく配置されています。
6. よくあるトラブルと対処法
| 症状 | 原因例 | 解決策 |
|---|---|---|
ruby が見つからない |
PATH 未設定、古いバージョンが残存 | 環境変数 Path を確認し C:\Ruby403\bin が唯一になるよう整理。旧版は「プログラムと機能」からアンインストール |
| MSYS2 のインストールが失敗する | ネットワーク遮断、既存の C:\msys64 が壊れている |
ridk install を再実行し、必要なら C:\msys64 ディレクトリを削除してから再度 rubyinstaller-devkit-*.exe を起動 |
| gem のビルドエラー(例: nokogiri) | MSYS2 ツールチェーンが古い・不完全 | ridk exec pacman -Syu でパッケージを最新化し、ridk exec ruby -v で動作確認 |
| winget が「パッケージが見つからない」 | パッケージキャッシュの古さ | winget source update 後に再実行 |
7. 補足:WSL(Ubuntu)で Ruby を利用したいとき
Windows 上で Linux 環境を併用するケースが増えているため、簡単な手順も紹介します。
|
1 2 3 4 5 |
$ wsl # Ubuntu がデフォルトの場合 $ sudo apt update $ sudo apt install ruby-full build-essential $ ruby -v # => ruby 4.0.3p0 (2026-04-02 ...) |
- 利点:Linux 用 gem のビルドがそのまま動作し、Windows 側の DevKit を意識せずに済む。
- 留意点:Rails の Windows 専用拡張や
win32‑service系 gem は利用できません。その場合は RubyInstaller でインストールした Windows 環境を使用してください。
8. 今後のバージョン管理とアップデート戦略
- 公式リリースが出たら
rubyinstaller-devkit-4.x.x-x64.exe(またはwinget install RubyInstallerTeam.Ruby)で最新インストーラを取得。- 定期的にハッシュとバージョン番号を比較
- 公式サイトの SHA256 とローカルファイルのハッシュが一致しない場合は再ダウンロード。
- 複数バージョンを併用したいとき
C:\Ruby40x系列ごとに別インストールし、PowerShell エイリアスやrbenv-win(非公式)で切り替え管理。
まとめ
- リリース情報は必ず公式サイトで確認 → 未公開版を誤って導入しないよう注意。
- RubyInstaller が最も手軽 かつ MSYS2 を自動設定でき、初心者に推奨。
- winget / scoop はスクリプト化が容易 で CI 環境や開発チーム向けに便利。
- インストール後は PATH とバージョンを必ず検証 → 問題があれば上記トラブルシューティングを参照。
これらの手順とポイントを抑えておけば、将来リリースされる Ruby 4 系列でもスムーズに Windows 環境を構築できるはずです。 Happy coding!