RubyMine 2026.1 Help

スコープとファイルの色

スコープ スコープ アイコン は、プロジェクト のファイルとフォルダーからなる命名されたセットです。 スコープを使うと、IDE のさまざまなビューで プロジェクト の項目を 視覚的に区別し 、特定の操作範囲を制限できます。

スコープを使用すると、ファイルを論理的に整理できます。 たとえば、テストソースをテストスコープに配置し、本番環境のコードを本番環境スコープに配置することができます。 これにより、大きな プロジェクト で作業しやすくなります。 インスペクションをテストのみで実行すると、コードベース全体で実行するよりも高速になります。

RubyMine には 事前定義スコープのセットが含まれていますが、独自に作成することもできます。 カスタムスコープには、たとえば自分が担当している プロジェクト の一部のみなど、任意のファイルセットを含められます。

RubyMine では、スコープはコードインスペクション、一部のリファクタリング、検索、コピーライト設定、コード解析のさまざまな機能など、 さまざまな機能で使用されます。

RubyMine にはローカルスコープと共有スコープの 2 種類があります。

  • ローカルスコープIDE 構成ディレクトリに格納されているため、VCS を通じて共有されず、チームの他のメンバーは使用できません。

  • 共有スコープ は VCS に追加されるため、プロジェクト で作業する人々は同じスコープを使用できます。 これらのスコープは、プロジェクト と一緒に .idea scopes フォルダーに格納されます。 各スコープは、 .xml 拡張子を持つファイルとして保存されます(例: MyProject/.idea/scopes/shared-scope.xml )。

プロジェクト が バージョン管理下にある場合は、共有スコープを使うのが理にかなっています。 VCS を使用しない場合は、ローカルスコープで十分です。

新しいスコープを定義する

RubyMine には一連の 定義済みスコープがありますが、独自のスコープを定義することもできます。

  1. Ctrl+Alt+S を押して設定を開き、 外観 & 振る舞い | スコープ を選択します。

  2. スコープの追加 」ボタン (スコープ追加ボタン) をクリックし、定義するスコープの種類 (ローカルまたは 共有) を選択します。

    後で VCS で共有する チェックボックスを使用して、選択したスコープの状態(ローカルまたは共有)を変更できます。

    新しいスコープを作成する: 共有スコープとローカルスコープ間の選択
  3. 開いたダイアログで、新しいスコープに名前を付け、 OKです。 をクリックします。

  4. 新しいスコープにファイルを追加します。 プロジェクト ツリーで必要な項目を選択し、ツリーの右側にあるいずれかのオプションをクリックします:

    • 含める: 選択したアイテムを含めます。 フォルダーを含める場合、このアクションはこのフォルダー内にあるファイルのみを追加します。 ネストされたすべてのサブフォルダーとその内容は含まれません。

    • 再帰的に含める: ネストされたサブフォルダーとその内容とともに、選択したフォルダーを含めます。

    • 除外: 選択したアイテムをスコープから除外します。 フォルダーを除外する場合、このアクションはこのフォルダー内にあるファイルのみを削除します。 ネストされたすべてのサブフォルダーとその内容はスコープに残ります。

    • 再帰的に除外する: 選択したフォルダーをネストされたサブフォルダーとその内容と共に除外します。

    ファイルとフォルダーが追加された新しいスコープ

    スコープにファイルを追加すると、RubyMine は式を作成し、それを パターン フィールドに表示します。

    ボタンを使わずに、 パターン フィールドにパターンを スコープ言語構文リファレンスを参考に手動で入力することもできます。

  5. 変更を適用して、ダイアログを閉じます。

選択したスコープで表示されるファイルとフォルダーは、どれが含まれているかそうでないかが分かるように、異なる色で表示されます:

  • 緑色のサンプル スコープに含まれるファイルとフォルダー。

  • ダークブルーの色見本 除外されたファイルとフォルダーと包含されたファイルとフォルダーの両方を含むフォルダー。

  • ブラックのカラーサンプル 選択した範囲から除外されるファイルとフォルダー。

カスタムスコープを作成すると、 プロジェクト ツールウィンドウと、アクションを適用するファイルの数を制限できる すべてのダイアログでそのスコープを見つけることができます。

プロジェクトツールウィンドウに表示される新しいスコープ

定義済みスコープ

RubyMine では定義済みスコープのセットが提供されています。 IDE は、ファイルに関する情報に基づいて、これらのスコープにファイルを自動的に追加します。 これらのスコープは変更できないことに注意してください。

定義済みスコープのリスト

  • プロジェクトファイル: プロジェクト コンテンツルート内のすべてのファイルが含まれます。

  • 問題: 構文エラーのある プロジェクト コンテンツルート内のファイルが含まれます。

  • すべての変更ファイル: 最近変更されたすべてのファイルが含まれます。

  • スクラッチとコンソール: プロジェクト ツールウィンドウにある スクラッチとコンソール ディレクトリのすべてのファイルが含まれます。

  • 最近表示したファイル および 最近変更したファイル: エディターで開いたり変更した最後の 50 個のファイルが含まれます。 最近のファイルの数を変更するには、 Ctrl+Alt+S を押して設定を開き、 拡張設定 を選択して、 最近使用したファイルの最大数 フィールドを検索し、希望する数を指定します。

  • プロジェクトとライブラリ: プロジェクト コンテンツルート内のすべてのファイルと、すべてのモジュール依存関係(ライブラリとインタープリター)が含まれます。

  • Git によって追跡されるプロジェクトファイル: Git でバージョン管理されている プロジェクト コンテンツルート内のすべてのファイルが含まれます。

  • Git-Ignored を除くプロジェクトファイル: プロジェクト コンテンツルート内のすべてのファイル(Git のバージョン管理下にあるファイルとバージョン管理されていないファイルの両方)が含まれますが、 .gitignore で指定されたファイルは除きます。

  • プロジェクトのプロダクション用ファイル: テストソースルートを除く プロジェクト コンテンツルート内のすべてのファイルが含まれます。

  • プロジェクトテストファイル: テストソースのルートにあるファイルが含まれます。 プロジェクト ツールウィンドウ(Alt+1 )では、この範囲は テスト ビューに対応します。

  • 非プロジェクトファイル: このスコープは、 プロジェクト ツールウィンドウのビューとしてのみ利用できます。 ライブラリとインタープリターが含まれます。

  • ファイルを開く: 現在エディターで開いているファイルが含まれます。

  • 現在のファイル: エディターで現在アクティブなファイルに対応します。

  • 選択したファイル: ツールウィンドウで選択されたファイルが含まれます(たとえば、 プロジェクト ツールウィンドウ(Alt+1))。

  • ローカルの変更 (これらのスコープは、 VCS 統合が有効になっているの場合に表示されます)

    • すべての変更ファイル: すべての変更リストから VCS にまだ追加されていない変更を含む変更されたファイルが含まれます。

    • デフォルト変更リスト: デフォルト 変更リストから VCS にまだ追加されていない変更を含む変更されたファイルが含まれます。

    • 「変更リスト名」: 特定のカスタム変更リストから VCS にまだ追加されていない変更が加えられた変更済みファイルが含まれます。

スコープを色に関連付ける

異なるスコープに属するファイルは、検索結果、エディタータブ、 プロジェクト ツールウィンドウ (Alt+1) で異なる色でハイライトできます。

エディタータブと検索結果での範囲のハイライト

各スコープに、独自の色を割り当てることができます。 例: ファイルを開く スコープに色を割り当て、 プロジェクト ツールウィンドウにこの色を表示するように IDE を構成できます。 この場合、エディターで現在作業しているファイルは、プロジェクトツリーで色分けされます。 これにより、プロジェクト のナビゲーションがさらに速く、簡単になります。 ファイルの色はスコープに関連してのみ機能することに注意してください。

スコープと同様に、色の関連付けは ローカル共有できます。

  • ローカル色のみ はあなただけに表示され、VCS を通じて共有されません。

  • 共有色 はバージョン管理下に置かれるため、プロジェクト で作業する人々は同じ色の関連付けを使用できます。 これらは、プロジェクト フォルダーの .idea 配下の fileColors.xml ファイル(例: MyProject/.idea/fileColors.xml )に格納されます。

新しい色の関連付けを作成する

  1. Ctrl+Alt+S を押して設定を開き、 外観 & 振る舞い | ファイルカラー を選択します。

  2. ファイルカラーを有効化する のチェックボックスが選択されていることを確認してから、色を使用する場所を選択します: エディタータブで使用する または プロジェクトビューで使用する を選択します。

    プロジェクトビューで使用する チェックボックスを選択すると、 プロジェクト ツールウィンドウ (Alt+1) と検索結果 (たとえば、 複数ファイル内検索 ダイアログ Ctrl+Shift+F) に色が表示されます。

  3. 追加 ボタン (追加アイコン) をクリックし、色を設定するスコープを選択します。

    事前定義されたスコープの 1 つを選択するか、 カスタムスコープを使用できます。

  4. 必要なスコープの横にある矢印 右矢印 アイコン をクリックし、開いたリストから色を選択します。

    独自の色を構成するには、 カスタム をクリックします。

    カスタムスコープの色の選択
  5. 色を編集するには、 列で必要なスコープに対応するセルをクリックし、リストから新しい色を選択します。

  6. VCS を介して色を 共有するには、 VCS で共有する 列の対応する行のチェックボックスを選択します。 チェックボックスがオフの場合、色は ローカルで使用されます。

    VCS を介してカラーを共有する
  7. 変更を適用して、ダイアログを閉じます。

ファイルが複数のスコープに含まれている場合、スコープの順序が重要になります。RubyMine はローカルスコープから順に上から下へスコープを処理します。 つまり、そのようなファイルにはリストの最後のスコープの色が IDE で適用されます。

RubyMine で色の関連付けを異なる順序で処理したい場合は、スコープの順序を変更できます。

スコープの順序を変更する

  1. Ctrl+Alt+S を押して設定を開き、 外観 & 振る舞い | スコープ を選択します。

  2. 移動するスコープを選択し、 上に移動 (上へ移動ボタン) または 下に移動 (下へ移動ボタン) ボタンをクリックします。 または、 Alt+Up または Alt+Down を押します。

  3. 変更を適用して、ダイアログを閉じます。

スコープの使用例

次の例は、日常業務でスコープを使用する方法を示しています。

  • 特定のファイルグループのみをインスペクションします。

    スコープを使用すると、コードベースの特定の部分をインスペクションできます。 たとえば、本番環境のコードをテストコードとは別にインスペクションできます。 さらに、最近変更されたファイルに異なるインスペクションセットを適用することで、新しい変更がより厳密なチェックを通過するようにすることもできます。

    詳細は インスペクションを実行する をご覧ください。

  • 検索を制限し、結果を置き換えます。

    複数ファイル内検索 および 複数ファイル内置換 機能でスコープを使用すると、無関係な結果の数を減らし、リファクタリングを高速化できます。

    詳細は プロジェクト内ターゲットの検索と置換 をご覧ください。

    検索を制限して結果を置換する
  • ナビゲーションにはスコープを使用します。

    プロジェクト ツールウィンドウでは、スコープを使用してナビゲーションを簡素化することもできます。 必要なスコープを選択することで、現在必要な項目のみを含む簡素化されたツリーを作成できます。

    詳細は プロジェクトツールウィンドウ をご覧ください。

    プロジェクトツールウィンドウのスコープ
  • 特定のファイルのみを再フォーマットします。

    スコープを使用すると、現在のファイルやコードベース全体だけでなく、特定のファイルのみを再フォーマットできます。 たとえば、コードに変更を加えた後、最近変更されたファイルをコードスタイルの要件に準拠するように再フォーマットできます。

    詳細は コードの整形と再配置 をご覧ください。

    再フォーマットの範囲を選択する
  • 異なるファイルセットごとに異なるコピーライト表示を設定します。

    これは、プロジェクト内のファイルに異なるコピーライト所有者がいる場合や、サードパーティまたはオープンソースプロジェクトからのファイルで、元のコピーライトを保持したい場合など、さまざまな状況で役立ちます。

    詳細は コピーライト をご覧ください。

    スコープとプロファイルの関連付け
2026 年 6 月 2 日