Contents
1️⃣ 前提条件と環境確認
| 確認項目 | 方法・コマンド | 判定基準 |
|---|---|---|
| OS が 64bit か | 設定 → システム → バージョン情報 の「システムの種類」 |
「64-bit operating system」 |
| 管理者権限の取得 | スタートメニューで PowerShell／コマンドプロンプト を右クリック → 「管理者として実行」 | UAC が表示され、Administrator: とプレフィックスが付くこと |
ポイント
管理者権限のターミナルを常に使用すると、インストール途中での権限エラーを防げます。
2️⃣ RubyInstaller + Devkit（公式インストーラ）による手順
2‑1. ダウンロードと SHA256 検証
|
1 2 3 4 5 6 |
# 1. 公式サイトから exe を取得 (例: rubyinstaller-devkit-3.2.2-1-x64.exe) $exe = "rubyinstaller-devkit-3.2.2-1-x64.exe" # 2. SHA256 ハッシュを計算 $hash = Get-FileHash -Algorithm SHA256 $exe $hash.Hash.ToLower() |
公式ページ (https://rubyinstaller.org/downloads/) に掲載されているハッシュと上記出力が一致すれば、ファイルは改ざんされていません。
2‑2. インストーラ実行時の推奨設定
| 設定項目 | 推奨状態 |
|---|---|
| Add Ruby executables to your PATH | ✅ チェック（必須） |
| Associate .rb files with this Ruby installation | 任意（エディタでダブルクリックしたい場合にチェック） |
Run ridk install to setup MSYS2 |
✅ 実行（デフォルト選択） |
MSYS2 のインストール
ウィザードが表示されたら 「1: MSYS2 base installation」 → 「3: Update the installed toolchain」 を順に実行してください。
2‑3. PATH が反映されているか確認
インストーラ完了後、同じ管理者ターミナルで以下を実行します。
|
1 2 3 |
where ruby ruby -v |
期待される出力例（※パスは Ruby 3.2 の実際のディレクトリ）
|
1 2 3 |
C:\Ruby32-x64\bin\ruby.exe ruby 3.2.2 (2023-03-30 revision e51014f9c0) [x64-mingw-ucrt] |
注意
インストーラが PATH を更新しても、既に開いているシェルには反映されません。ターミナルを一度閉じて再起動するか、$Env:Path = [System.Environment]::GetEnvironmentVariable('Path','Machine')で手動リロードしてください。環境変数の変更が全く反映されない場合は PC の再起動 が確実です。
3️⃣ winget によるワンラインインストール
3‑1. 基本コマンド
|
1 2 3 |
# 管理者権限 PowerShell で実行 winget install RubyInstallerTeam.Ruby.3.2 --silent --accept-source-agreements |
--silent… GUI を表示せずにインストール--accept-source-agreements… ライセンス同意を自動化
このコマンドで Ruby 本体 + Devkit が一括導入されます。
3‑2. インストール後の PATH 確認
|
1 2 3 |
where ruby ruby -v |
期待されるパス
C:\Ruby32-x64\bin\ruby.exe（インストール先はシステム設定で変更可能です）
もし where ruby が何も返さない場合は、ターミナルを再起動するか PC を再起動してください。refreshenv は Chocolatey 専用コマンドなので、winget 環境では使用できません。
4️⃣ インストール後の基本操作
| コマンド | 説明 |
|---|---|
ruby -v |
Ruby 本体のバージョン確認 |
gem install bundler |
Bundler（Gem 管理ツール）のインストール |
bundle -v |
Bundler バージョン確認 |
gem install rails |
Rails フレームワークの導入（任意） |
rails new myapp --skip-bundle |
Rails 雛形プロジェクト作成 |
サンプルスクリプト
|
1 2 3 4 |
# hello.rb を作成し実行 'puts "Hello, world!"' > hello.rb ruby hello.rb # => Hello, world! |
5️⃣ トラブルシューティング
| 症状 | 主な原因 | 推奨対処 |
|---|---|---|
| MSYS2 の更新が失敗 | ネットワーク遮断、pacman データベースの古さ | ridk exec pacman -Syu を手動実行し、再度インストーラを起動 |
| ruby コマンドが認識されない | PATH がまだ古いシェルに残っている | ターミナルを閉じて新しく開くか PC 再起動 |
| 管理者権限不足でエラー | 非管理者ターミナルで winget/インストーラ実行 |
「管理者として実行」した PowerShell で再試行 |
ヒント
エラーメッセージ全文で Web 検索すると、公式ドキュメントや GitHub Issue がすぐに見つかります。
6️⃣ アンインストールと複数バージョン管理
6‑1. アンインストール手順
- 設定 → アプリと機能 を開く
- 「Ruby 3.2.x」を選択し「アンインストール」
この操作でレジストリや PATH のクリーンアップが行われます。
6‑2. 複数バージョンを使い分ける方法（例）
(a) uru を利用
|
1 2 3 4 5 6 7 8 |
winget install uru-team.uru # インストール # Ruby のインストール先を登録（例: C:\Ruby32-x64 と C:\Ruby30-x64） uru admin add "C:\Ruby32-x64" uru admin add "C:\Ruby30-x64" # デフォルトバージョン切替 uru admin set 3.2 # => Ruby 3.2 が有効化 |
(b) rbenv-win を利用
|
1 2 3 4 5 |
git clone https://github.com/rbenv/rbenv.git $HOME\.rbenv # PowerShell のプロファイルに以下を追記 $env:PATH = "$HOME\.rbenv\bin;$env:PATH" Invoke-Expression (& rbenv init -) |
どちらが向いているか
-uruは Windows 向けにシンプルな切替コマンドだけで済むため、初心者に最適。
-rbenv-winは Unix 系のrbenvと同様の操作感を求める開発者向けです。
7️⃣ まとめ
| 項目 | 方法 |
|---|---|
| OS 判定 | Windows 10 64bit を確認 |
| 管理者権限 | PowerShell/コマンドプロンプトを「管理者として実行」 |
| インストール手段 | ①公式インストーラ＋SHA256検証 ②winget ワンライン |
| PATH の確定 | where ruby・ruby -vで確認、シェル再起動または PC 再起動が必要な場合あり |
| 基本操作 | gem install bundler → Bundler / Rails などの導入 |
| トラブル対策 | エラーは「シェル再起動」か「PC 再起動」で解決できることが多い |
| バージョン管理 | uru または rbenv-win を活用 |
これで Windows 10 環境に Ruby 3.2 と Devkit が安全にインストールでき、開発をすぐに開始できるようになります。 Happy coding!