Ruby

WindowsでRuby 3.2を導入する方法:winget・インストーラ完全ガイド

ⓘ本ページはプロモーションが含まれています

もっとスキルを活かしたいエンジニアへ

スポンサードリンク
働き方から選べる

無料で使えて良質な案件の情報収集ができるサービス

エンジニアの世界では、「いつでも動ける状態を作っておけ」とよく言われます。
技術やポートフォリオがあっても、自分に合う案件情報を日常的に見れていないと、いざ動こうと思った時に比較や判断が難しくなってしまいます。
普段から案件情報が集まる環境を作っておくと、良い案件が出た時にすぐ動きやすくなりますよ。
筆者自身も、メガベンチャー勤務時代に年収1,500万円を超えた経験があります。振り返ると、技術だけでなく「どんな案件や働き方があるか」を日頃から見ていたことが、キャリアの選択肢を広げるきっかけになりました。
このブログを読んでくれた方に感謝を込めて、実際に使っている情報収集サービスを紹介します。

フルリモート・週3日・高単価、どんな条件も妥協したくないなら

フリーランスボードに無料会員登録する

利用者10万人以上。業界最大規模45万件の案件。AIマッチ機能や無料の相場情報が人気。

年収800万円以上のキャリアアップ・ハイクラス正社員を視野に入れているなら

Beyond Careerに無料相談する

内定獲得率90%以上。紹介先企業とは役員クラスのコネクションがある安心と信頼できるエージェント。


スポンサードリンク

はじめに: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 月時点の情報)。

※パッケージ詳細は Microsoft Store のページ(https://aka.ms/winget-search?Id=RubyInstallerTeam.Ruby.3.2)で確認できます。

2. インストールコマンドの実行

管理者権限で起動した PowerShell に以下を入力します。

  • winget は依存関係(MSYS2/Devkit)も自動的に取得し、インストール完了後に C:\Ruby32-x64\bin をシステム PATH に追加します。
  • インストール中は「Downloading」「Installing」等のプログレスが表示され、数十秒で終了します。

3. インストール先ディレクトリについて

公式インストーラのデフォルトパスは C:\Ruby32-x64(バージョン 3.2 系)ですが、インストーラの更新に伴い Ruby30-x64Ruby33-x64 と変わる可能性があります。インストール後に実際のパスを確認したい場合は次のコマンドをご利用ください。


インストール結果の確認

1. Ruby 本体のバージョン表示

ruby -v を実行すると、以下のような形式で情報が出力されます(ビルド番号やリビジョンはインストーラの時点に依存するため例示です)。

  • 3.2.x がインストールされたマイナーバージョン、
  • [x64-mingw-ucrt] が 64 ビット Windows 用のビルドであることを示します。

2. gem 環境とインストールディレクトリの確認

出力中の INSTALLATION DIRECTORY が次に類似していれば正常です(パスは実際のインストール先に合わせて変わります)。


公式サイトから RubyInstaller のインストーラを利用する方法

1. ダウンロードページへのアクセスと対象ファイルの選択

公式ダウンロードページ(https://rubyinstaller.org/downloads/)にアクセスし、「Ruby+Devkit 3.2.x‑1 (x64)」.exe を取得します。

2. インストーラ実行時の必須チェック項目

インストールウィザードで次のオプションは 必ず有効にしてください

  • Add Ruby executables to your PATHPATH へ自動登録し、どのシェルからでも ruby が呼び出せるようにします。
  • Run ridk install to install MSYS2 and development toolchain – 後述する MSYS2 のセットアップを自動で開始させます。

3. インストール完了後の確認手順


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 が依存する場合のみインストールしてください。 ★★☆☆☆

手順まとめ

  • インストール先はデフォルトで C:\Ruby32-x64\msys64 に配置されます。
  • 選択肢の説明が不足しがちですが、「Base」+「Toolchain」 が最小構成かつ多くの gem で問題なく動作します。

Bundler のインストールと簡単な検証プロジェクト

1. Bundler 本体の導入

gem install bundler で最新バージョンを取得し、インストール後にバージョンを確認します。管理者権限が必要ですが、--user-install を付与すればユーザ領域へインストールできます。

2. サンプルプロジェクトで依存解決を体験

  1. 任意の作業ディレクトリ(例: C:\work\sample_ruby)を作成し、次の内容で Gemfile を保存します。

    ruby
    source "https://rubygems.org"

    gem "rack", "~> 3.0"

  2. コマンドプロンプト(または 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 でのアップデート手順

  • winget は最新パッケージ情報を取得し、差分だけを上書きします。インストール済みの MSYS2 環境はそのまま保持されます。

2. 公式インストーラでの上書きインストール

  1. ダウンロードページから最新バージョンの .exe を取得
  2. 前回と同じディレクトリ(例: C:\Ruby32-x64)に上書きインストール

この方法は パッチ適用 に有効です。既存の gem 環境は自動的に引き継がれます。

3. 複数バージョンを併存させる場合

  • 各バージョンを別ディレクトリ(例: C:\Ruby32-x64C:\Ruby33-x64)にインストール
  • システム PATH の順序を書き換えて使用したいバージョンを先頭に配置します。

注意setx は永続的に環境変数を変更しますが、現在開いているシェルには即時反映されません。新しいシェルを起動して確認してください。


まとめ

  • Windows 10/11 の 64 ビット環境で 管理者権限 を持つシェルからインストールすれば、PATH 自動登録と MSYS2 開発ツールチェーンが確実に構成されます。
  • winget RubyInstallerTeam.Ruby.3.2 が最も手軽で、公式パッケージは Base + Development toolchain の組み合わせを推奨します。
  • インストール後は ruby -vgem env でバージョンと gem ディレクトリを確認し、bundler を使って依存関係管理のテストを行いましょう。
  • トラブルが起きた際は UAC/SmartScreen の許可、MSYS2 の再インストール、PATH の再読込を順に試すと解決しやすくなります。

これらの手順を踏めば、Windows 上でも快適に Ruby 3.2 開発環境が構築できるはずです。 Happy coding!

スポンサードリンク

もっとスキルを活かしたいエンジニアへ

スポンサードリンク
働き方から選べる

無料で使えて良質な案件の情報収集ができるサービス

エンジニアの世界では、「いつでも動ける状態を作っておけ」とよく言われます。
技術やポートフォリオがあっても、自分に合う案件情報を日常的に見れていないと、いざ動こうと思った時に比較や判断が難しくなってしまいます。
普段から案件情報が集まる環境を作っておくと、良い案件が出た時にすぐ動きやすくなりますよ。
筆者自身も、メガベンチャー勤務時代に年収1,500万円を超えた経験があります。振り返ると、技術だけでなく「どんな案件や働き方があるか」を日頃から見ていたことが、キャリアの選択肢を広げるきっかけになりました。
このブログを読んでくれた方に感謝を込めて、実際に使っている情報収集サービスを紹介します。

フルリモート・週3日・高単価、どんな条件も妥協したくないなら

フリーランスボードに無料会員登録する

利用者10万人以上。業界最大規模45万件の案件。AIマッチ機能や無料の相場情報が人気。

年収800万円以上のキャリアアップ・ハイクラス正社員を視野に入れているなら

Beyond Careerに無料相談する

内定獲得率90%以上。紹介先企業とは役員クラスのコネクションがある安心と信頼できるエージェント。


-Ruby