IntelliJ IDEA 2024.1 ヘルプ

Ruby インタープリターを構成する

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

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

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

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

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

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

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

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

  2. Ruby SDK および Gem ページで、add ボタンをクリックし、インタープリターを選択します:

    New local interpreter
  3. Ruby 実行可能ファイルへのパスを指定します。例:

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

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

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

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

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

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

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

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

  2. Ruby SDK および Gem ページで、add ボタンをクリックし、カスタム環境でのインタープリターを選択します:

  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 SDK および Gems ページでインタープリターを選択する

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

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

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

    Ruby SDK and Gems
  3. 選択した Ruby インタープリター /gemset の場合は、右側にインストールされている gems が表示されます。Ruby gems のサポートについて詳しくは、Bundler を参照してください。

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

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

  1. Ctrl を 2 回押します。

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

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

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

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

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

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

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

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

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

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

    New remote interpreter
  2. リモート Ruby インタープリターの構成ダイアログで、必要なオプション(SSH、Docker Compose など)を選択し、必要な設定を指定します。

    Configure remote ruby interpreter

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

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

    Edit path mappings

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

    Edit Project Path Mappings

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

インタープリターの名前を変更する

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

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

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

    Rename parameter in code and Ruby interpreter

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

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

    Enter a new name for the Ruby interpreter

トラブルシューティング

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

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

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

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

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

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

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

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

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

関連ページ:

プロジェクト

IntelliJ IDEA では、プロジェクトは、ソースコード、テスト、使用するライブラリ、ビルド手順、個人設定を 1 つのユニットに整理できます。IntelliJ IDEA のプロジェクトは、モジュールをまとめて保持し、モジュール間の依存関係を提供し、共有構成を保存するシェルです。プロジェクトとモジュールの詳細については、「プロジェクトの構成」を参照してください。プロジェクトフォーマット:IntelliJ IDEA には、プロジェクトの構成を保存できる 2 種類の形式があります。ファイルベー...

Ruby 開発環境をセットアップする

前提条件の依存関係をインストールする:IntelliJ IDEA は、Ruby(Ruby MRI)のリファレンス実装と、JRuby や TruffleRuby などの代替実装をサポートしています。Ruby インタープリターをインストールする前に、Ruby をコンパイルするために必要な依存関係をマシンにインストールする必要があります。例: オペレーティングシステムによっては、これらの依存関係に次のツールとライブラリが含まれる場合があります。Ubuntu:build-essential、libssl...

Ruby バージョンマネージャー

Linux または macOS に Ruby をインストールする最も一般的な方法は、RVM や rbenv などのバージョンマネージャーを使用することです。バージョンマネージャーを使用すると、マシンに複数の Ruby バージョンをインストールし、すばやく切り替えることができます。IntelliJ IDEA は、ローカルマシンにインストールされ、次のバージョンマネージャーによって保守されているインタープリターを自動的に検出する RVM、gemsets 用の rbenv-gemsets プラグインを備えた rbe...

Bundler

IntelliJ IDEA は Bundler との統合をサポートし、IDE 内でアプリケーションの gem 依存関係を処理できるようにする Bundler をインストールする:原則として、インストールされている Ruby インタープリターには Bundler がインストールされています。そうでない場合は、次のいずれかの方法でプロジェクト ZDK に Bundler をインストールできます。メインメニューからを選択します。を 2 回押し、呼び出されたポップアップでコマンドを実行します。IntelliJ...

なんでも実行

なんでも実行は、実行 / デバッグ構成、アプリケーション、スクリプト、コマンド、タスクを起動し、最近のプロジェクトを開くための簡単な方法です。また、入力時に候補を生成することにより、適切なコマンド構文を使用するのにも役立ちます。コマンドを呼び出すと、なんでも実行はそれ以降の作業を適切なツールに委譲します。なんでも実行ポップアップを開く:を 2 回押します。または、ツールバーのをクリックします。アイコンはデフォルトでは非表示になっています。ツールバーにアイコンを追加するには、設定ダイアログ ()...

アプリケーションを実行する

プロジェクト / モジュールに SDK のセットアップがある場合は、IntelliJ IDEA から直接アプリケーションを実行できます。簡単な方法:エディターから実行プログラムにパラメーターを渡さず、プログラムを開始する前に特定のアクションを実行する必要がない場合は、エディターから直接実行できます。クラス宣言の近くのガターでクリックし、実行を選択します。現在のファイルを実行するツールバーの専用オプションを使用して、単一のファイルを実行できます。実行ボタンとデバッグボタンがアクティブになり、現在...