RubyMine 2026.1 Help

Bundler

RubyMine は Bundler との統合をサポートし、IDE 内でアプリケーションの gem 依存関係を処理できるようにします。

Bundler をインストールする

通常、 Ruby インタープリターをインストールすると、Bundler もインストールされます。 インストールされていない場合は、以下のいずれかの方法で プロジェクトインタープリターに Bundler をインストールできます。

  • メインメニューから ツール | Bundler | Bundler をインストールする を選択します。

  • Ctrl を 2 回押し、呼び出されたポップアップで gem install bundler コマンドを実行します。

  • RubyMine の ターミナルエミュレーターを開き、 gem install bundler コマンドを実行します。

バンドル初期化

Bundler をインストールした後、現在のプロジェクト用の Gemfile を生成できます:

  • メインメニューから ツール | Bundler | 初期化 を選択します。

gem をインストールする。

Gemfile で定義された gem を次の手順でプロジェクトインタープリターにインストールできます:

  1. 次のいずれかを実行してください:

    • Ctrl を 2 回押します。 呼び出されたポップアップで、 bundler と入力し始め、 bundle install を選択して Enter を押します。

    • メインメニューから ツール | Bundler | インストール を選択します。

    • Gemfile を開き、プロジェクトインタープリターでハイライト表示されている gem にカーソルを置き、 Alt+Enter を押します。 「bundler」を使用して、不足している gem をインストールする を選択して Enter を押します。

      Gemfile インスペクション
  2. (オプション)デフォルトでは、現在の プロジェクトインタープリター Gemfile.lock で指定された必要な Bundler バージョンがない場合、RubyMine によってインストールされます。

    このオプションを無効にするには、 次の手順を実行します。

  3. バンドルインストール ダイアログで、 実行 をクリックして、引数なしで bundle install コマンドを実行します。

    バンドルインストールダイアログ

    必要に応じて、このコマンドを実行するときに必要な引数を渡します。例:

    • --without production Gemfile 内の 本番 グループで指定されているものを除くすべての gem をインストールします。

    • --path vendor/bundle: gems を vendor/bundle プロジェクトディレクトリにインストールします。 この場合、Bundler は .bundle/config ファイルをプロジェクトのルートに追加します。 RubyMine はこの構成ファイルを処理して、gem が vendor/bundle にインストールされていることを検出します。

  4. gems がインストールされるまで待ちます。 実行ツールウィンドウに次のプロセスが表示されます。

    Bundler の出力

    インストールされている gem は、 設定 | 言語とフレームワーク | Ruby インタープリター Ctrl+Alt+S ページで確認できます。

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

    また、プロジェクトビュー Alt+1外部ライブラリ ノードでも見つけられます。

    外部ライブラリ

Bundler 設定をカスタマイズする

Bundler メニューを使用して、必要な Bundler バージョンの自動インストールを無効または有効にし、Bundler コマンドのデフォルト引数をカスタマイズします。

Bundler 設定メニュー

Bundler の自動インストールを無効にする

デフォルトでは、RubyMine は Gemfile.lock ファイルで指定された Bundler のバージョンを自動的にインストールします。 この設定を無効にするには、以下の手順を実行してください。

  1. 設定(Ctrl+Alt+S )を開き、 ツール | Bundler に移動します。

  2. 常に必要なバージョンの Bundler をインストールする チェックボックスをクリアします。

このオプションを無効にすると、RubyMine は該当する通知ウィンドウで確認後にのみ必要なバージョンの Bundler をインストールします。

デフォルト引数をカスタマイズする

このオプションを使用すると、Bundler コマンドのデフォルト引数を指定できます。 これにより、Bundler コマンドを実行するたびに引数を尋ねられることなく、これらのコマンドを実行できます。

  1. 設定(Ctrl+Alt+S )を開き、 ツール | Bundler に移動します。

  2. デフォルト引数を使用する チェックボックスが選択されていることを確認し、下のテキストフィールドに必要な引数を入力します。

gems をリモートインタープリターにインストールする

リモート Ruby インタープリターを使用している場合、RubyMine はリモートマシン上にある Gemfile を使って gem をインストールします。 これには、ローカルプロジェクトとリモートプロジェクトのファイル間のマッピングを構成する必要があります。 これを行うには、 設定 | 言語とフレームワーク | Ruby インタープリターパスマッピングを編集 パスマッピングを編集 ボタンをクリックします。

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

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

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

マッピングを設定したら、 ローカルインタープリターに Gems をインストールする命令を使用して gems をインストールします。

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

バンドル実行

RubyMine は Ruby および Rails アプリケーションの実行、デバッグ、テスト、デプロイを 実行 / デバッグ構成を使って汎用的に行えます。 実行 / デバッグ構成は、必要なコマンドをすばやく実行できるようにする起動パラメーターのデフォルトセットを提供します。 これらのコマンドは、バンドルのコンテキストで次のように実行できます。

  1. 以下のいずれかの方法で 実行 / デバッグ構成 ダイアログを開きます。

    • メインメニューから 実行 | 実行構成の編集 を選択します。

    • ナビゲーションバーが表示された状態(表示 | 外観 | ナビゲーションバー )で、実行 / デバッグ構成セレクターから 実行構成の編集 を選択します。

      実行構成の編集
    • Alt+Shift+F10 を押してから、 0 を押します。

  2. 開いた 実行 / デバッグ構成 ダイアログで、必要な構成を選択し、 Bundler タブを開きます。

  3. バンドルのコンテキストでスクリプトを実行する('bundle exec') オプションを構成します:

    • 自動検出 :可能な場合に bundle exec でコードを実行するには、このオプションを選択します。

    • 無効bundle exec の使用を無効化するには、このオプションを選択します。

    OKです。 をクリックしてください。

ドライモードでバンドルチェックを実行する

RubyMine は bundle check をドライモードで実行するオプションを提供します。 この場合、Bundler はロックファイルを作成または更新しません。

  1. メインメニューで、 ヘルプ | アクションの検索 Ctrl+Shift+A に移動します。

  2. Run silent bundle check with --dry-run と入力し始めます。 オプションを選択し、 Enter を押して有効にします。

    ドライモードの有効化

    このオプションを有効にしたら、自分でロックファイルを管理する必要があります。 Gemfile を変更した後、 bundle check/bundle lock を実行してロックファイルを更新します。

2026 年 6 月 2 日