RubyMine 2026.1 Help

RuboCop

RubyMine は RuboCop との連携をサポートしており、IDE 内、たとえばコードエディターでその違反を修正できます。

RuboCop 違反

プロジェクト全体をチェックし、すべての RuboCop 警告を一つのレポートに表示することもできます。

必要に応じて、 標準(英語)ラッパーを有効にしてプロジェクトソースの分析に使用することができます。

RuboCop/Standard gems をインストールする

RuboCop インスペクションはデフォルトで RubyMine で有効化されており、 プロジェクトのインタープリター に 'rubocop' gem をインストールする必要があります。 この gem がインストールされていない場合、RubyMine はそのインストールを提案します。

Rubocop をインストールする

Standard でプロジェクトを分析したい場合は、 Gemfile に「standard」gem を追加し、 インストールしてください。

RuboCop と Standard でリントするおよびフォーマットを設定する

RubyMine を使用すると、相互に排他的な 5 つの lint モードとフォーマットモードのセットを通じて、プロジェクト内で RuboCop標準 がどのように適用されるかを制御できます。

モードを選択することで、プロジェクトで lint とフォーマットの両方に 一貫したワークフローが使用され、ツール間の競合が回避されます。

  1. 設定 | ツール | RuboCop に進みます。

    RuboCop Lint とフォーマットモード
  2. リントする & フォーマット作業 セクションで、以下の 5 つのモードから 1 つを選択してください。

    • デフォルト: RuboCop はインスペクションのみを実行し、RubyMine はフォーマット処理を行います。

    • 標準 lint: Standard gem でリントするのみ実行し、フォーマットは RubyMine で維持されます。

    • 保存時に Standard を適用: 標準の lint を実行し、保存時に自動的にフォーマットします。

    • RuboCop サーバーモード: パフォーマンス向上のため RuboCop をサーバーモードで実行します。RuboCop 1.31 以上が必要です。 Windows または JRuby ではサポートされていません。

    • 保存時に RuboCop を実行: サーバーモード以外でセーブ時に rubocop -a を実行し、自動修正可能な問題をすべて自動的に修正します。

RuboCop インスペクションの設定

RuboCop インスペクションのエディター内ハイライト表示を有効または無効にするには、次の手順を実行します。

  1. 設定 ダイアログ Ctrl+Alt+S を開きます。

  2. エディター | インスペクション ページへ移動し、 Ruby | Gems および gem 管理RuboCop インスペクションを有効化/無効化してください。

    標準を有効にする
  3. (オプション) 重要度マッピング グループのインスペクションの重大度に RuboCop の重大度がどのようにマッピングされるかを設定します。

    デフォルトでは、RubyMine は RuboCop の 重大度インスペクションの重大度を次のようにマッピングします:

    RuboCop の重大度

    インスペクション重大度

    リファクタリング、コンベンション

    弱い警告

    警告

    警告

    エラー、致命的

    エラー

    重要度マッピングを変更するには、該当する重要度のリストを展開し、必要なオプションを選択してください。

    重大度マッピング

エディターで RuboCop 違反を修正

RuboCop インスペクションを有効化すると、RubyMine がコードエディター内で違反をハイライトします。 警告の説明を確認して修正するには、次の手順を実行します。

  1. ハイライトされた箇所にキャレットを移動し、 Ctrl+F1 を押します。

    エディターでの RuboCop 警告
  2. 違反を修正するには、 Alt+Enter を押します。 ファイル内の提案されたすべての違反を修正することも、クラス違反または cop department による特定の修正のみを適用することもできます。

    RuboCop の違反を修正

Rubocop インスペクションを実行する

RubyMine では、対応する インスペクション を実行することで、プロジェクト全体の RuboCop 違反を見つけることができます。 これを行うには、以下の手順に従います。

  1. Ctrl+Alt+Shift+I を押すか、メインメニューで コード | コードの解析 | インスペクション名を指定して実行… に移動します。

  2. ポップアップで RuboCop を探し、 Enter を押します。

  3. 実行 'RuboCop' ダイアログで、分析したいファイルの範囲を指定します。 必要に応じて 「standard」gem を使用 を有効にしてください。 OKです。 をクリックしてください。

  4. RubyMine がプロジェクトを分析するまでお待ちください。 インスペクション結果 ツールウィンドウでは、 自動修正可能なすべての RuboCop 違反を修正 ボタンを使用して RuboCop の違反を調査し、自動修正可能なものを修正できます。

    RuboCop インスペクションの結果

    個々のファイルを確認したり、クラス違反や cop department ごとに特定の修正を適用したりすることもできます。

    RuboCop インスペクションの結果

RuboCop 設定ファイル

RuboCop では、構成ファイルを通じて動作をカスタマイズできます。 RubyMine は .rubocop.yml ファイルを自動検出し、それを使ってインスペクションを実行します。 または、インスペクションのカスタム構成ファイルを指定することもできます。

.rubocop.yml

RubyMine は .rubocop.yml ファイルで指定されたすべての設定を考慮します。 例: 特定の cop department のチェックを無効にした場合、 エディターは対応する違反を表示しません。 さらに、これらの違反は RuboCop インスペクションレポートには表示されません。

カスタム RuboCop 構成

カスタム RuboCop 構成

  1. 設定 ダイアログ(Ctrl+Alt+S )で、 ツール | Rubocop を選択します。

  2. 設定ファイル フィールドに構成ファイルを指定してください。

設定ファイルを選択

構成ファイルが選択されていない場合、プロジェクト内に .rubocop.yml があれば、そのインスペクションを実行します。 それ以外の場合、RubyMine はデフォルト設定を使用します。

使い方: カスタムオプションで開いたファイルに対して RuboCop を実行する

現在開いているファイルに対してカスタムオプションで RuboCop を実行する必要がある場合があります。 例: これは、RuboCop インスペクションが 無効になっているとき、または特定の RuboCop アクションに ショートカットを割り当てたいときに便利です。

この例では、現在開いているファイルのレイアウト違反を修正するために RuboCop を 外部ツールとして使う方法を紹介します。

カスタム RuboCop アクションを作成する

  1. 設定 ダイアログ(Ctrl+Alt+S )で、 ツール | 外部ツール を選択します。

  2. 追加ボタン をクリックし、次の設定を指定します:

    編集ツールダイアログ
    • 名前 :RubyMine インターフェースに表示されるメニューコマンド(ツール メニューとコンテキストメニュー)。

    • グループ: コマンドが属するグループの名前。 既存のグループを選択するか、新しいグループの名前を入力できます。

    • プログラム: RuboCop 実行可能ファイルの名前。

    • 引数 :コマンドラインで指定するように、実行可能ファイルに渡される引数。 ここでは -x RuboCop オプションを使用して現在のファイルに対してレイアウト警官のみを実行します。

    • 作業ディレクトリ: ツールが実行される現在の作業ディレクトリへのパス。

  3. OKです。 をクリックしてツールを追加し、変更を適用します。

  4. (オプション) 作成したアクションにショートカットを割り当てます。 設定 ダイアログ (Ctrl+Alt+S) で、 キーマップ を選択し、 RuboCop ノードで 外部ツール アクションを見つけて、ショートカットを指定します。

    ショートカットを設定する

カスタム RuboCop アクションを実行する

  • 作成した RuboCop アクションを実行するには、 ツール メインメニューへ移動するか、ファイルのコンテキストメニューを使用します。

    カスタムアクションを実行

    コマンド実行時、その出力が 実行 ツールウィンドウに表示されます。

    カスタムアクション出力
2026 年 6 月 2 日