IntelliJ IDEA 2026.1 Help

Ruby インタープリターの構成

Ruby コードを IntelliJ IDEA で操作するには、少なくとも 1 つの Ruby インタープリターを設定する必要があります。 インタープリターは、現在開いているプロジェクト用に設定するか、 新しいプロジェクトを作成するときに設定できます。

Ruby インタープリターの構成は、 インストール方法によって異なります。

  • パッケージマネージャー(Ubuntu では apt 、macOS では Homebrew など)または Ruby インストーラー(たとえば、Windows では RubyInstaller )を使用して Ruby をインストールした場合は、 手動で追加する必要があります。

  • バージョンマネージャーを使用して Ruby をインストールした場合、IntelliJ IDEA はインタープリターを自動で検出します。 その場合は、 必要なバージョンを選択できます。

  • IntelliJ IDEA から直接 Ruby をインストールした場合、インストールされたインタープリターが現在のプロジェクトのデフォルトとして設定されます。

  • 隔離された環境(Docker、Vagrant、WSL など)にインストールされた Ruby を使用している場合、IntelliJ IDEA を使用すると、それを リモートインタープリターとして構成できます。

ローカルインタープリターを追加する

インタープリターを追加する

  1. プロジェクト構造 ダイアログ Ctrl+Alt+Shift+S を開き、左側の モジュール を選択します。

  2. Ruby インタープリター ページで、 追加 ボタンをクリックし、 インタープリター を選択します。

    新しいローカルインタープリター
  3. Ruby 実行可能ファイルへのパスを指定します。例:

    • Homebrew を使用して macOS にインストールされた Ruby の /usr/local/bin/ruby

    • Ruby 用の /usr/bin/ruby apt を使用して Linux にインストールされました。

    • RubyInstaller を使用して Windows にインストールされた Ruby の C:\Ruby26-x64\bin\ruby.exe

    IntelliJ IDEA は、自動的に検出されたインタープリターとともに、追加されたインタープリターを表示します。

    リストからインタープリターを削除するには、インタープリターを選択して、 remove ボタンをクリックします。

カスタム環境でインタープリターを追加する

IntelliJ IDEA を使用すると、カスタム環境を使用して、IntelliJ IDEA 内から任意の Ruby コマンドを実行できます。 これを行うには、ローカルインタープリターを追加するときに、環境変数値または構成スクリプトへのパスを指定する必要があります。

  1. プロジェクト構造 ダイアログ Ctrl+Alt+Shift+S を開き、左側の モジュール を選択します。

  2. Ruby ページで、 追加 ボタンをクリックし、 カスタム環境でのインタープリター を選択します。

  3. 呼び出されたダイアログで、 インタープリターを追加する 説明に従って Ruby 実行可能ファイルへのパスを指定します。 次に下記のいずれかの方法で カスタム環境 を構成します。

    • 環境変数の値を直接指定します。

      サンプル: env API_KEY=123

    • シェルスクリプトを使用して環境変数をロードする場合は、このスクリプトへの絶対パスを指定する必要があります。

      サンプル: /bin/bash /Users/jetbrains/sample_app/env.sh

    • direnv(英語) を使用して環境変数をロードおよびアンロードする場合は、 .envrc ファイルがあるディレクトリへのパスを direnv exec コマンドに渡します。

      サンプル: direnv exec /Users/jetbrains/sample_app

    • Shadowenv(英語) を使用してプロジェクト環境をカスタマイズする場合は、プロジェクトディレクトリへのパスを shadow exec コマンドに渡します。

      サンプル: shadowenv exec --dir /Users/jetbrains/sample_app --

    OK をクリックして、インタープリターを追加します。

  4. 追加したインタープリターを選択し、 設定 ダイアログで OK をクリックします。

自動検出されたインタープリターを選択する

Ruby ページでインタープリターを選択する。

バージョンマネージャーで管理されている自動検出された Ruby インタープリターを選択するには、次の手順に従ってください。

  1. プロジェクト構造 ダイアログ Ctrl+Alt+Shift+S を呼び出して、左側の モジュール を選択します。

  2. 必要な Ruby インタープリターを選択します。 また、RVM と rbenv バージョンマネージャー用の gemset も選択できます。

    Ruby インタープリター
  3. 選択した Ruby インタープリター /gemset の場合、右側にインストールされている gems が表示されます。

なんでも実行を使用してインタープリターを切り替える

RVM または rbenv を使用してローカル Ruby インタープリター を管理する場合は、 なんでも実行を使用して必要なインタープリターをすばやく設定できます。

  1. Ctrl を 2 回押します。

  2. 呼び出されたポップアップで、 rvm use または rbenv shell と入力し始め、必要なインタープリターを選択して Enter を押します。

  3. (オプション) 必要に応じて、変更されたインタープリターを通知するポップアップの ロールバック ボタンをクリックします。

リモートインタープリターを追加する

Docker、Vagrant、Windows Subsystem for Linux (WSL) などのさまざまなリモート開発ツールを使用すると、分離された環境を使用してアプリケーションを開発できます。 これは、次のような場合など、さまざまなケースで役立ちます。

  • ローカルマシン構成への影響を回避するために、隔離された環境で開発してください。

  • デプロイするのと同じオペレーティングシステムでアプリケーションを実行、デバッグ、テストします。

  • Windows Subsystem for Linux を使用して、Linux にデプロイされたアプリケーションを開発します。

Docker Compose、Vagrant ボックス、または WSL を使用して、リモート環境で必要な Ruby/Rails セットアップを準備できます。 その後、IntelliJ IDEA に リモート Ruby インタープリターを追加し、IDE から直接、分離された環境でアプリケーションを 実行デバッグテストできます。

リモートインタープリターを使用している場合、IntelliJ IDEA はリモートマシンからローカルキャッシュに gems をダウンロードして、コードインサイト機能を使用できることに注意してください。 この場合、新しい gems が IDE 外のリモートマシンにインストールされた場合があります。 ローカルキャッシュに保存されている gems のセットを更新するには、 Ruby インタープリター ページの Synchronize gems Synchronize gems ボタンをクリックします。

リモート Ruby インタープリターを設定するには、次の手順を実行します。

  1. ツールバーで、 追加 をクリックし、 リモートインタープリターまたはバージョンマネージャー を選択します。

    新しいリモートインタープリター
  2. リモート Ruby インタープリターの構成 ダイアログで、以下の各タブの手順を実行します。

    1. 次のオプションを指定します。

      リモート Ruby インタープリターの構成: SSH
      • SSH 構成: 既存の SSH 構成の一覧を展開するか、省略記号ボタンをクリックして新規作成します。

      • Ruby またはバージョンマネージャー パス: Ruby インタープリターまたはバージョンマネージャーの実行可能ファイルへのパスを指定します。

    2. OK をクリックします。 前の手順でバージョンマネージャー実行可能ファイルへのパスを指定した場合、IntelliJ IDEA はリモートアプリケーションを実行するために使用される Ruby インタープリターの選択を提案します。

    3. Ruby ページで、追加したインタープリターを選択し、 OK をクリックします。

    1. 開いたダイアログで、 Docker を選択し、次のオプションを指定します。

      リモート Ruby インタープリターの構成: Docker
      • サーバー: コンテナーを実行するために使用する Docker サーバーを設定します。

      • イメージ名:: 事前にビルドしたイメージ を選択します。

      • Ruby またはバージョンマネージャー パス: デフォルトの ruby 値のままにして、Ruby インタープリターへのパスを自動で検出します。

    2. OK をクリックします。 前の手順でバージョンマネージャー実行可能ファイルへのパスを指定した場合、IntelliJ IDEA はリモートアプリケーションを実行するために使用される Ruby インタープリターの選択を提案します。

      追加したインタープリターは Ruby ページで使用できます。

    3. 追加したインタープリターを選択し、 Ruby インタープリター ダイアログで OK をクリックします。

      IntelliJ IDEA がプロジェクトの分析処理を完了し、コード編集ヘルパー用の Dockerイメージとコンテナーを作成するまで待ちます。

      Docker ツールウィンドウ
    1. 開いたダイアログで、 Docker Compose を選択し、次のオプションを指定します。

      リモート Ruby インタープリターの構成: Docker Compose
      • サーバー: このオプションでは、コンテナーを実行するために使用する Docker サーバーを指定します。

      • 構成ファイル: docker-compose.yml ファイルはそのままにします。

      • サービスウェブサービスを選択します。

      • 環境変数: 通常、変更する必要はありません。

        カスタマイズする場合は、 環境変数の編集 アイコンをクリックして 環境変数 ダイアログを開きます。

        新しい変数を追加することも(+ アイコンをクリック)、デフォルトで含まれているシステム環境変数を編集することもできます。

        環境変数の編集
      • Node.js ランタイムパス: デフォルトの ruby 値のままにして、Ruby インタープリターへのパスを自動で検出します。 インタープリターまたはバージョンマネージャー実行可能ファイルへのパスを手動で指定することもできます。

    2. OK をクリックします。 前の手順でバージョンマネージャー実行可能ファイルへのパスを指定した場合、IntelliJ IDEA はリモートアプリケーションを実行するために使用される Ruby インタープリターの選択を提案します。

      追加したインタープリターは Ruby ページで使用できます。

      Ruby インタープリター: Docker Compose
    3. 追加したインタープリターを選択し、 Ruby インタープリター ダイアログで OK をクリックします。

      IntelliJ IDEA がプロジェクトの分析処理を完了し、コード編集ヘルパー用の Dockerイメージとコンテナーを作成するまで待ちます。

      Docker ツールウィンドウ: コード編集ヘルパー
    1. 呼び出されたダイアログで、 Vagrant を選択します。

      rm_remote_sdk_vagrant.png

      プロジェクトのルートフォルダーに稼働中の仮想マシンを指す Vagrantfile が含まれている場合、IntelliJ IDEA は Vagrant インスタンスフォルダー を自動で検出し、仮想マシンへのアクセスに使用される Vagrant ホスト URL を表示します。 必要に応じて、 Vagrant インスタンスフォルダー を変更して、別の仮想マシンを使用することができます。

      Ruby またはバージョンマネージャー パス で、Ruby インタープリターまたはバージョンマネージャー実行可能ファイルへのパスを指定してください。 OK をクリックします。

    2. (オプション) 前の手順でバージョンマネージャーの実行可能ファイルへのパスを指定した場合、IntelliJ IDEA により、リモートアプリケーションの実行に使用する Ruby インタープリターの選択を求められます。

    3. Ruby インタープリター ページで追加したインタープリターを選択し、 OK をクリックします。

      IntelliJ IDEA がリモートマシンからローカルキャッシュに gem をダウンロードするまで待ちます。 これはインデックス作成に必要です。

    IntelliJ IDEA を使用すると、ローカルプロジェクトで Windows Subsystem for Linux (WSL)(WSL および WSL 2)にインストールされているリモート Ruby インタープリターを使用できます。

    1. 開いたダイアログで、 WSL を選択します。

      目的の Linux ディストリビューション を選択します。

      Ruby またはバージョンマネージャー パス で、Ruby インタープリターまたはバージョンマネージャー実行可能ファイルへのパスを指定してください。 OK をクリックします。

    2. (オプション) 前のダイアログでバージョンマネージャーの実行可能ファイルへのパスを指定した場合、IntelliJ IDEA により、リモートアプリケーションの実行に使用する Ruby インタープリターの選択を求められます。

    3. Ruby インタープリター ダイアログで追加したインタープリターを選択し、 OK をクリックします。

(オプション)ローカルプロジェクトとリモートプロジェクトのファイル間のマッピングを編集します。

  1. ローカルプロジェクトとリモートプロジェクトのファイル間のマッピングを指定します。 これを行うには、 Edit Path Mappings ボタンをクリックします。

    パスマッピングの編集
  2. プロジェクトパスマッピングの編集 ダイアログで、ローカルおよびリモートプロジェクトのルートパスを指定します。

    プロジェクトパスマッピングの編集

    IntelliJ IDEA は Vagrant の 同期フォルダー(英語)や WSL マッピングなどを検出することに注意してください。 これらのマッピングはこのダイアログにリストされ、変更することはできません。

インタープリターを編集する

Ruby インタープリターの名前をカスタマイズして、すばやく区別し、重複を避けることができます。

  1. プロジェクト構造 ダイアログ Ctrl+Alt+Shift+S を開き、左側の モジュール を選択します。

  2. 必要な Ruby インタープリターを右クリックし、 名前の編集 を選択します。

    コードおよび Ruby インタープリターのパラメーターの名前を変更する

    または、必要な Ruby インタープリターを選択して、 アイコンを使用するか、 Enter を押すこともできます。

  3. インタープリターの編集 ダイアログで、インタープリターの新しい名前を入力し、 OK をクリックします。

    Ruby インタープリターの新しい名前を入力する

RVM gemsets を作成する

RVM gemset を作成するには、 製品構造 ダイアログ (Ctrl+Alt+Shift+S) を開き、 モジュール | Ruby インタープリター に移動して、次の手順を実行します。

  1. 必要なインタープリターを右クリックして、 新しい RVM gemset を選択します

    Ruby インタープリターページ
  2. ダイアログが開き、gemset が作成される Ruby インタープリター を選択します。 次に、gemset の名前を指定し、 OK をクリックします。

    新しい rvm gemset を作成するダイアログ
  3. Ruby インタープリター ページには、選択したインタープリターの子として gemset が表示されます。

    Ruby インタープリターページ

    アスタリスクが gemset 名に追加されることに注意してください。 つまり、gemset はまだ作成されていません。 作成するには、 製品構造 ダイアログで 適用 または OK をクリックします。

トラブルシューティング

Ruby プロジェクトのローカルインタープリターを構成する

新しく複製された Ruby プロジェクトのローカルインタープリターを構成するときに問題が発生した場合(たとえば、 Ruby インタープリター ページが表示されない場合)、既存のソースからこのプロジェクトを開いてみてください。

  1. メインメニューで ファイル | 新規 | 既存ソースからプロジェクト へ移動します。

  2. プロジェクトへのパスを提供します。

  3. プロジェクトのインポート ダイアログで、 外部ソースからプロジェクトを作成 オプションを選択し、 次へ をクリックします。

  4. プロジェクト名と、プロジェクトを作成するディレクトリへのパスを指定します。 次へ をクリックします。

  5. プロジェクトルートに追加するディレクトリを選択し、 次へ をクリックします。

  6. プロジェクトで使用するフレームワークを選択します。 完了 をクリックします。

IntelliJ IDEA がプロジェクトを開いたら、 インタープリターを追加する で説明されている手順に従って、ローカルインタープリターを構成します。

インタープリターを削除する

  1. プロジェクト構造 | プロジェクト設定 | モジュール | Ruby インタープリター

  2. インタープリターのリストから、削除する手動で追加されたインタープリターを選択します。

  3. remove ボタンを Ruby ページ上部のツールバーからクリックしてください。

    追加されたインタープリターを削除する
  4. 呼び出されたダイアログで OK をクリックします。

2026 年 3 月 30 日