Contents
はじめに:Windows に Ruby 3.2 を導入する意義
Ruby 3.2 はパフォーマンス改善と新しい型システムが加わり、Web アプリからスクリプトまで幅広い開発で活躍します。Windows 環境でも公式の RubyInstaller が提供するバイナリを利用すれば、C 拡張やネイティブ gem のビルド環境が自動で整うため、追加設定に悩むことはほとんどありません。本記事では、管理者権限が必要な点 と PATH への自動登録 を踏まえた上で、2 通りのインストール手順(winget・公式インストーラ)とその後の確認方法を詳しく解説します。
前提条件と管理者権限の取り扱い
このセクションでは、本記事で想定している環境と、インストール時に必ず満たすべき要件をまとめます。
- OS: Windows 10(1809)以降、Windows 11 推奨
- アーキテクチャ: 64 ビット (x64) のみサポート
- 必要な権限: ローカル管理者または「管理者として実行」された PowerShell/コマンドプロンプト
ポイント:インストーラはシステムディレクトリへの書き込みと
PATHへの自動登録を行うため、必ず管理者権限でシェルを起動してください。UAC が表示されたら「はい」で許可し、SmartScreen の警告が出た場合も「実行」を選択します。
winget(Windows Package Manager)で RubyInstaller 3.2 を導入する手順
1. winget の準備とパッケージ ID の確認
winget は Windows 10 バージョン 1809 以降に標準搭載されていますが、インストールされていない場合は Microsoft Store から 「Windows Package Manager」 アプリを取得してください。
公式の RubyInstaller パッケージは次の ID で提供されています(2026 年 5 月時点の情報)。
|
1 2 |
RubyInstallerTeam.Ruby.3.2 |
※パッケージ詳細は Microsoft Store のページ(https://aka.ms/winget-search?Id=RubyInstallerTeam.Ruby.3.2)で確認できます。
2. インストールコマンドの実行
管理者権限で起動した PowerShell に以下を入力します。
|
1 2 3 |
# 管理者として実行していることを再確認 winget install RubyInstallerTeam.Ruby.3.2 |
wingetは依存関係(MSYS2/Devkit)も自動的に取得し、インストール完了後にC:\Ruby32-x64\binをシステムPATHに追加します。- インストール中は「Downloading」「Installing」等のプログレスが表示され、数十秒で終了します。
3. インストール先ディレクトリについて
公式インストーラのデフォルトパスは C:\Ruby32-x64(バージョン 3.2 系)ですが、インストーラの更新に伴い Ruby30-x64 や Ruby33-x64 と変わる可能性があります。インストール後に実際のパスを確認したい場合は次のコマンドをご利用ください。
|
1 2 |
where ruby |
インストール結果の確認
1. Ruby 本体のバージョン表示
ruby -v を実行すると、以下のような形式で情報が出力されます(ビルド番号やリビジョンはインストーラの時点に依存するため例示です)。
|
1 2 |
ruby 3.2.xpyyy (2026-??-?? revision zzzzzz) [x64-mingw-ucrt] |
3.2.xがインストールされたマイナーバージョン、[x64-mingw-ucrt]が 64 ビット Windows 用のビルドであることを示します。
2. gem 環境とインストールディレクトリの確認
|
1 2 |
gem env |
出力中の INSTALLATION DIRECTORY が次に類似していれば正常です(パスは実際のインストール先に合わせて変わります)。
|
1 2 |
C:\Ruby32-x64\lib\ruby\gems\3.2.0 |
公式サイトから RubyInstaller のインストーラを利用する方法
1. ダウンロードページへのアクセスと対象ファイルの選択
公式ダウンロードページ(https://rubyinstaller.org/downloads/)にアクセスし、「Ruby+Devkit 3.2.x‑1 (x64)」 の .exe を取得します。
2. インストーラ実行時の必須チェック項目
インストールウィザードで次のオプションは 必ず有効にしてください。
- Add Ruby executables to your PATH –
PATHへ自動登録し、どのシェルからでもrubyが呼び出せるようにします。 - Run
ridk installto install MSYS2 and development toolchain – 後述する MSYS2 のセットアップを自動で開始させます。
3. インストール完了後の確認手順
|
1 2 3 4 |
where ruby # パスが表示されれば PATH 登録成功 ruby -v gem env |
MSYS2 / Devkit の詳細なインストール手順と選択肢の説明
ridk install を実行すると、MSYS2 環境の構成を選択する画面が表示されます。初心者に最も安全な組み合わせは 「1. Base installation」 と 「3. MSYS2 development toolchain」 の 2 つです。
| 選択肢 | 内容 | 初心者向けの推奨度 |
|---|---|---|
| 1. Base installation | 基本的な Unix ライクツール(bash, tar, gzip など)を提供します。Ruby のビルドや gem のコンパイルに必須です。 |
★★★★★ |
| 2. MSYS2 system update | すでにインストール済みのコンポーネントを最新に保ちます。初回インストール時は省略可ですが、定期的なメンテナンスで実行してください。 | ★★★☆☆ |
| 3. MSYS2 development toolchain | C コンパイラ(gcc)や make, pkg-config といった開発ツールをインストールします。C 拡張 gem のビルドに必須です。 |
★★★★★ |
| 4. Additional optional packages | 任意で選択できる追加ライブラリ(例: OpenSSL, libyaml)です。特定の gem が依存する場合のみインストールしてください。 | ★★☆☆☆ |
手順まとめ
|
1 2 |
ridk install # インタラクティブに上記 1 と 3 を選択 |
- インストール先はデフォルトで
C:\Ruby32-x64\msys64に配置されます。 - 選択肢の説明が不足しがちですが、「Base」+「Toolchain」 が最小構成かつ多くの gem で問題なく動作します。
Bundler のインストールと簡単な検証プロジェクト
1. Bundler 本体の導入
gem install bundler で最新バージョンを取得し、インストール後にバージョンを確認します。管理者権限が必要ですが、--user-install を付与すればユーザ領域へインストールできます。
|
1 2 3 |
gem install bundler bundler -v # 例: Bundler version 2.5.0 |
2. サンプルプロジェクトで依存解決を体験
-
任意の作業ディレクトリ(例:
C:\work\sample_ruby)を作成し、次の内容で Gemfile を保存します。ruby
source "https://rubygems.org"gem "rack", "~> 3.0"
-
コマンドプロンプト(または PowerShell)でディレクトリに移動し、
bundle installを実行します。cmd
cd C:\work\sample_ruby
bundle install
成功すると rack-3.x.x.gem がインストールされ、Gemfile.lock が生成されます。
ポイント:Bundler が正しく機能すれば、Rails や Sinatra といったフレームワークの依存関係も同様に管理できるようになります。
トラブルシューティング
1. UAC/SmartScreen の対処法
- UAC が表示されたら「はい」をクリックし、インストールを続行してください。
- SmartScreen が警告した場合は「詳細情報」→「実行」を選択します。公式の RubyInstaller は Microsoft 署名が付与されているため安全です。
企業環境向けヒント:IT 管理者に対して
RubyInstallerTeam.Ruby.3.2の SHA‑256 ハッシュ(インストーラ実行ファイルのプロパティで確認可能)を提示し、例外登録を依頼するとスムーズです。
2. MSYS2 インストール中のエラー対策
| 症状 | 主な原因 | 解決策 |
|---|---|---|
ridk install が途中で失敗 |
プロキシ設定やネットワーク制限 | 環境変数 http_proxy/https_proxy を正しく設定し、再実行 |
| コンパイルエラーが出る | PATH に長い文字列が含まれる | インストール先を短い C:\Ruby32-x64 などに変更して再インストール |
gcc が見つからない |
Toolchain が未選択 | 再度 ridk install → 「3. MSYS2 development toolchain」だけでも実行 |
3. PATH が正しく反映されない場合
新しいターミナルを開かずに古いウィンドウでコマンドを実行すると、古い PATH が使われ続けます。インストール直後は必ず 新規の PowerShell / コマンドプロンプト を起動して確認してください。
アップデートと複数バージョン管理
1. winget でのアップデート手順
|
1 2 |
winget upgrade RubyInstallerTeam.Ruby.3.2 |
wingetは最新パッケージ情報を取得し、差分だけを上書きします。インストール済みの MSYS2 環境はそのまま保持されます。
2. 公式インストーラでの上書きインストール
- ダウンロードページから最新バージョンの
.exeを取得 - 前回と同じディレクトリ(例:
C:\Ruby32-x64)に上書きインストール
この方法は パッチ適用 に有効です。既存の gem 環境は自動的に引き継がれます。
3. 複数バージョンを併存させる場合
- 各バージョンを別ディレクトリ(例:
C:\Ruby32-x64、C:\Ruby33-x64)にインストール - システム
PATHの順序を書き換えて使用したいバージョンを先頭に配置します。
|
1 2 |
setx PATH "C:\Ruby33-x64\bin;%PATH%" |
注意:
setxは永続的に環境変数を変更しますが、現在開いているシェルには即時反映されません。新しいシェルを起動して確認してください。
まとめ
- Windows 10/11 の 64 ビット環境で 管理者権限 を持つシェルからインストールすれば、
PATH自動登録と MSYS2 開発ツールチェーンが確実に構成されます。 winget RubyInstallerTeam.Ruby.3.2が最も手軽で、公式パッケージは Base + Development toolchain の組み合わせを推奨します。- インストール後は
ruby -v・gem envでバージョンと gem ディレクトリを確認し、bundlerを使って依存関係管理のテストを行いましょう。 - トラブルが起きた際は UAC/SmartScreen の許可、MSYS2 の再インストール、PATH の再読込を順に試すと解決しやすくなります。
これらの手順を踏めば、Windows 上でも快適に Ruby 3.2 開発環境が構築できるはずです。 Happy coding!