Contents
スポンサードリンク
1. ダウンロード先とインストーラの概要
| アーキテクチャ | ファイル名例 (2024‑10 時点) | 主な対象 |
|---|---|---|
| 64 ビット | Ruby+Devkit-3.2.4-1-x64.exe |
Windows 10/11 の最新 PC（推奨） |
| 32 ビット | Ruby+Devkit-3.2.4-1-x86.exe |
古いハードウェアや互換性が必要な環境 |
- 配布元: https://rubyinstaller.org/downloads/ （公式ダウンロードページ）
- インストーラの特徴
- MRI 本体（バイナリ）と MSYS2 ベースの開発ツールチェーンを同梱。
- インストール後に
ridk installで必要なパッケージを自動取得できる。
2. インストール手順
2‑1. 実行ファイルの起動と基本設定
- ダウンロードした
Ruby+Devkit-3.2.x-1-x64.exeを 管理者権限なしで実行。 - ライセンス画面で「I accept the License」にチェックし、Next。
- インストール先はデフォルトのままで構いません（例:
C:\Ruby32-x64)。 - ※パスはバージョンに合わせて
Ruby32としています。実際のディレクトリ名が異なる場合は、インストーラ画面に表示されたものをそのまま使用してください。 - 「Install for me only (recommended)」を選択し Next → Install をクリック。
このオプションはユーザー環境変数だけを書き換えるため、管理者権限が不要です。
2‑2. MSYS2 と開発ツールの自動セットアップ
インストーラが完了したら、以下のコマンドで MSYS2 環境と必須ツールを導入します。
|
1 2 3 4 5 6 |
# Ruby が PATH に登録されていることを確認 ruby -v # => ruby 3.2.x ... # 必要パッケージを一括インストール ridk install 1 2 3 |
| オプション | 内容 |
|---|---|
1 |
基本的な MSYS2 環境（pacman 本体） |
2 |
開発ツールチェーン（gcc、make、patch 等） |
3 |
推奨追加パッケージ（autoconf、automake など） |
インストール中に表示される質問はデフォルトで Enter を押すだけで完了します。
3. 環境変数 PATH の確認と修正
3‑1. 自動追加が成功したかチェック
|
1 2 |
echo %PATH% |
上記出力に以下の2つが含まれていれば OKです。
C:\Ruby32-x64\binC:\msys64\usr\bin（MSYS2 のバイナリディレクトリ）
3‑2. 手動で修正する場合
- スタートメニュー → 設定 → システム → バージョン情報 → 環境変数
- 「ユーザー環境変数」または「システム環境変数」の
Pathを選択し、編集。 - 上記ディレクトリが無ければ 新規 ボタンで追加し、不要な古い Ruby パス（例:
C:\Ruby27-x64\bin）は削除します。
変更後はコマンドプロンプトを再起動してください。
4. 動作確認
|
1 2 3 |
ruby -v # => ruby 3.2.x (2024‑xx‑xx) [x64-mingw32] gem -v # => 3.5.x |
次に簡単なスクリプトを実行します。
hello.rb を作成:
|
1 2 3 |
# hello.rb puts "Hello, Ruby on Windows!" |
実行:
|
1 2 3 |
ruby hello.rb #=> Hello, Ruby on Windows! |
この結果が得られたら、Ruby 本体と gem コマンドは正しく動作しています。
5. Bundler の導入と基本的な使い方
|
1 2 3 4 |
gem install bundler # Bundler をインストール mkdir myapp && cd myapp bundle init # Gemfile を生成 |
Gemfile に例として Sinatra を追記：
|
1 2 3 4 |
# Gemfile source "https://rubygems.org" gem "sinatra", "~> 3.0" |
続いて依存 gem をインストールします。
|
1 2 3 |
bundle install bundle list # インストールされた gem の一覧が表示される |
Bundler が正しく機能すれば、プロジェクト単位での依存管理が可能になります。
6. よくあるエラーと対処法
| エラーシナリオ | 原因 | 解決策 |
|---|---|---|
MSYS2 パッケージ不足（nokogiri のビルド失敗） |
必要な libxml2・libxslt が未インストール | ridk exec pacman -S mingw-w64-x86_64-libxml2 mingw-w64-x86_64-libxslt |
SSL 証明書エラー (SSL_connect エラー) |
Windows のルート証明書が古い | ridk exec pacman -Sy mingw-w64-x86_64-ca-certificates && ridk exec update-ca-trust |
| PATH への自動追加失敗 | インストール時に管理者権限が不足 | 管理者としてコマンドプロンプトを起動し、手順 3‑2 の通り手動で環境変数を修正 |
公式 FAQ（https://rubyinstaller.org/faq）でも同様の対処法が掲載されています。
7. VS Code と Ruby 拡張機能の推奨設定
7‑1. 必要な拡張機能
| 拡張名 | 作者 |
|---|---|
| Ruby | Peng Lv |
| Ruby LSP | Ruby Language Server (ruby-lsp) |
| RuboCop（コード整形） | RuboCop |
7‑2. settings.json のサンプル
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 |
{ // Ruby 本体へのフルパス。インストール先が C:\Ruby32-x64 の場合。 "ruby.interpreter.commandPath": "C:\\Ruby32-x64\\bin\\ruby.exe", // LSP を有効化 "ruby.lsp.enabled": true, // RuboCop がインストールされていれば自動整形をオンにする "ruby.format": "rubocop", // Bundler 環境でデバッグしたいときの設定 "debugger.ruby.useBundler": true } |
7‑3. デバッグ構成（launch.json）
|
1 2 3 4 5 6 7 8 9 10 11 12 |
{ "version": "0.2.0", "configurations": [ { "type": "ruby", "request": "launch", "name": "Debug Ruby File", "program": "${file}" } ] } |
これで F5 キーを押すだけで、現在編集中の *.rb ファイルがデバッグ実行されます。
8. 参考リンク（脚注）
[^1]: Progate 「Windows 用 Ruby 環境」ページ
https://prog-8.com/articles/windows-ruby
[^2]: RubyInstaller 公式ダウンロードページ
https://rubyinstaller.org/downloads/
[^3]: RubyInstaller FAQ（MSYS2 関連のトラブルシューティング）
https://rubyinstaller.org/faq
まとめ
- 公式サイトから最新版
Ruby+Devkit-3.2.x‑1-x64.exeを取得し、デフォルトパスC:\Ruby32-x64にインストール。 - インストーラ完了後に
ridk install 1 2 3で MSYS2 と開発ツールを自動セットアップ。 %PATH%に Ruby と MSYS2 のパスが正しく追加されたか確認し、必要なら手動修正。ruby -v・gem -vと簡単なスクリプト実行で環境を検証。bundlerを導入してプロジェクトごとの依存管理を開始。- VS Code に Ruby 拡張と LSP 設定を加え、快適なエディタ・デバッガ体験を構築。
以上の手順を踏めば、Windows 上でも本格的かつ安全に Ruby 開発がスタートできます。ぜひ実際に試してみてください！
スポンサードリンク