Ruby

Windows 10/11 に Ruby 3.2 を手動・wingetでインストールする方法

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

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

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

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

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

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

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

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

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

Beyond Careerに無料相談する

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


スポンサードリンク

インストール前の準備と前提条件

Ruby 3.2 を Windows 10/11 の 64 ビット環境に導入する際、まずは OS が 64 ビットであること管理者権限が付与されたシェルで作業できること を確認してください。これらの前提が整っていないと、インストーラが必要なディレクトリへ書き込みできず、後続のセットアップでエラーになるケースが多く報告されています。また、公式サイトからパッケージを取得するために 安定したインターネット接続 が必須です。

以下では、作業をスムーズに進めるための具体的なチェック項目と推奨環境をまとめます。

  • 対象 OS:Windows 10(バージョン 1809 以降)または Windows 11 の 64 ビット版
  • 必要権限:管理者として PowerShell またはコマンドプロンプトを起動すること
  • ネット環境:HTTPS が通り、公式サイトや winget リポジトリへアクセス可能であること

参考:Ruby の公式インストールページでは Windows Package Manager(winget)の利用が推奨されています【Ruby のインストール】。


公式サイトから RubyInstaller 3.2 と Devkit を手動インストール

このセクションでは、公式ダウンロードページから RubyInstaller 3.2 (x64) とそれに同梱されている MSYS2(Devkit) を手作業で導入する手順を解説します。手動インストールはカスタマイズがしやすく、特定のバージョンやオプションを選択したい場合に有効です。

ダウンロード手順とファイル選択

公式サイト(Ruby のダウンロードページ)へアクセスし、「Windows 用」セクションから対象パッケージを取得します。
- rubyinstaller-devkit-3.2.x-x64.exe:インストーラ本体(Ruby 本体と Devkit が統合されています)。
- 必要に応じて別途配布される msys2-runtime-*.exe:MSYS2 のランタイムが分離されている場合の補助ファイルです。

ポイント:統合パッケージを選択すれば、後から Devkit を個別にインストールする手間が省けます。

インストーラ実行時の重要ポイント

インストーラを管理者権限で起動したら、以下の画面で必ずチェックしてください。これらは Ruby がネイティブ拡張(C 言語で書かれた gem)をビルドできる環境を整えるために不可欠です。

  1. MSYS2 のインストール – 「MSYS2 development toolchain をインストールする」にチェック
  2. PATH への自動追加 – 「Ruby の実行ファイルを PATH に追加する」オプションも有効化

これらの項目を省くと、後日手動で環境変数を修正したり、ridk install を再度走らせたりしなければならず、トラブルの温床となります。

MSYS2 の初回セットアップ(ridk install

インストールが完了したら、管理者権限で起動した PowerShell から次のコマンドを実行します。

表示されるメニューでは以下の選択肢を推奨します(デフォルトで OK です)。

  • 1 : MSYS2 基本ツール (base-devel) – コンパイラやビルドツールの基礎セット
  • 2 : MinGW‑w64 コンパイラ (mingw-w64-x86_64-toolchain) – 64 ビット向け C/C++ コンパイラ

途中で「Enter to continue?」と表示されたらそのまま Enter を押すだけで、必要なパッケージが自動的に取得・インストールされます。

インストール後の確認と Bundler 導入

セットアップ完了後は、まず Ruby 本体のバージョン情報を確認します。

次に、依存関係管理ツールである Bundler をインストールしておくと、Rails や Sinatra といったフレームワークの導入が格段に楽になります。

以上で手動インストールは完了です。必要に応じて gem update --system で RubyGems 本体も最新にしておくと、将来的な互換性が高まります。

参考:「Windows に Ruby をインストールする方法【RubyInstaller 3.2】」でも同様の流れが推奨されています。


winget コマンドによる一括インストール

winget(Windows Package Manager)を利用すれば、数行のコマンドで Ruby 本体と Devkit の両方を自動的に導入できます。この方法は手順がシンプルなだけでなく、将来的なアップデートも winget upgrade 1 行で実施できる点が魅力です。

winget でのインストールコマンド

PowerShell(管理者)から次のコマンドを入力してください。

  • --id:パッケージの正確な識別子
  • -e:完全一致検索モード(類似パッケージがヒットしないようにする)

コマンド実行後、以下の処理が自動的に進行します。

  • Ruby 3.2 本体の展開
  • MSYS2(Devkit)のインストールスクリプト呼び出し
  • PATH への自動登録

インストーラ途中で「MSYS2 のセットアップを実行しますか?」と尋ねられたら Yes を選択してください。

自動設定項目の確認方法

winget は UI がなくても、インストール後に環境変数が正しく反映されているか以下で検証できます。

これらのコマンドでエラーが出なければ、PATH 設定は正常に完了しています。

インストール後のバージョン確認

最終的に以下を実行し、Ruby と Bundler の状態を把握しておきましょう。

Bundler が未インストールの場合は、手動で次のコマンドを実行します。

winget 版でも ridk install が自動的に走らないケースがあります。その際は、前述の MSYS2 初回セットアップ 手順を手動で実行してください。

参考:Ruby の公式インストールページは「Windows Package Manager CLI を利用します」と明示しています【Ruby のインストール】。


よくあるトラブルと対処法

本章では、導入時に頻繁に遭遇する問題とその具体的な解決策をまとめます。事前に対処方法を把握しておくことで、インストール失敗による作業の中断を防げます。

PATH が反映されない場合

原因:インストーラ実行時に「PATH に自動追加」のチェックを外したか、PowerShell のセッションが古いままになっている。
対処:システム環境変数 Path に Ruby の bin ディレクトリ(例:C:\Ruby32-x64\bin)を手動で追加し、PowerShell を再起動します。現在のセッションで反映されているかは $env:PATH で確認できます。

MSYS2 インストールエラー

原因:ネットワーク障害や pacman のキャッシュ破損が主な要因です。
対処:以下の手順で再実行します。

エラーメッセージが出続ける場合は、一時的にプロキシ設定やファイアウォールを確認してください。

32bit/64bit が混在するケース

原因:過去にインストールした 32 ビット版 Ruby の残骸が PATH に残っていると、期待しないバージョンが呼び出されます。
対処:コントロールパネルの「プログラムの追加と削除」から不要な 32 ビット版 Ruby をアンインストールし、環境変数 Path から該当ディレクトリ(例:C:\Ruby24-x86\bin)を除去します。その後、ruby -v で正しいバージョンが表示されることを確認してください。

gem のインストールが失敗する場合

原因:SSL 証明書の検証エラーや gem コマンド自体が古いことが多いです。
対処:まず RubyGems を最新に更新します。

それでも失敗する場合は、gem source -r https://rubygems.org/ で既存のソースを削除し、再度 gem source -a https://rubygems.org/ を実行してからインストールを試みます。


インストール完了後の動作確認と次のステップ

Ruby が正しくインストールされたかどうかは、簡単なスクリプトや対話型シェル(IRB)でテストすると確実です。また、実際の開発に入る前に Bundler を使ったプロジェクト雛形を作成しておくと、環境構築が完了したことを視覚的に確認できます。

簡単な Ruby スクリプト実行

以下のコマンドで「Hello, Ruby 3.2!」が標準出力に表示されれば、Ruby 本体の動作は正常です。

エラーなく文字列が表示されたら、次のステップへ進みましょう。

IRB 起動で対話的確認

irb(Interactive Ruby)を起動し、簡単な式評価で標準ライブラリや REPL が機能しているか確かめます。

ここで Array#mapFile.read といった基本的なメソッドが使用できれば、標準ライブラリのロードに問題はありません。

Bundler の実践的活用例

実際のプロジェクトディレクトリを作成し、Bundler で依存関係管理を体験します。

bundle install が成功すれば、RailsSinatra といったフレームワークのインストールも同様に行える状態です。個別にインストールしたい場合は次のようにします。

これでローカル環境は本格的な Web アプリ開発向けに整いました。


まとめ

  • 前提条件:Windows 10/11 の 64 ビット版、管理者権限、インターネット接続が必須です。
  • 手動インストール:公式サイトから rubyinstaller-devkit-3.2.x-x64.exe を取得し、MSYS2 と PATH 追加を忘れずに設定します。その後 ridk install で開発ツールチェーンを整えます。
  • winget インストール:1 行のコマンドで Ruby 本体と Devkit が自動導入され、アップデートも winget upgrade だけで完了します。
  • トラブル対策:PATH 未反映・MSYS2 エラー・32/64 ビット混在は環境変数の見直しや ridk install の再実行で解決できます。
  • 動作確認ruby -virb、簡易スクリプト、Bundler を用いたプロジェクト雛形作成で正常性を検証してください。

以上の手順とチェックポイントを踏めば、Windows 上に安定した Ruby 3.2 環境が構築でき、Rails や Sinatra などのフレームワーク開発をすぐに始められます。ぜひ本稿を参考に、快適な Ruby ライフをスタートさせてください。

スポンサードリンク

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

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

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

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

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

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

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

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

Beyond Careerに無料相談する

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


-Ruby