IntelliJ IDEA 2026.1 Help

スコープとファイルカラー

スコープ the Scope icon は、プロジェクト内のファイル、パッケージ、フォルダーの名前付き設定です。 スコープを使用すると、さまざまな IDE 表示のプロジェクト項目を 視覚的に区別し 、特定の操作範囲を制限できます。

スコープを使用すると、ファイルを論理的に整理できます。 たとえば、テストソースをテストスコープに入れ、本番コードを本番スコープにまとめられます。 これにより、大規模な プロジェクト での作業が容易になります。 テストのみに対してインスペクションを実行する方が、コードベース全体に対して実行するよりも高速です。

IntelliJ IDEA には一連の 定義済みスコープが付属していますが、独自のスコープを作成することもできます。 カスタムスコープには任意のファイルを含められます。たとえば、担当している プロジェクト の部分だけを対象にできます。

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

IntelliJ IDEA には、ローカルと共有という 2 種類のスコープがあります。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    ボタンを使用する代わりに、 スコープ言語構文リファレンスを使用して、 パターン(P) フィールドにパターンを手動で入力することもできます。

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

選択した範囲で表示されるファイルとフォルダーは、含まれているものと含まれていないものを理解するのに役立つように、さまざまな色で表示されます。

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

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

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

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

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

定義済みのスコープ

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

事前定義されたスコープのリスト

  • プロジェクトファイル: プロジェクトコンテンツルート内のすべてのファイルが含まれます。 詳細については、 コンテンツルート を参照してください。 ライブラリおよび SDK はこのスコープには含まれません。

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

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

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

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

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

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

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

  • プロジェクトのプロダクション用ファイル: テストソースルートを除くプロジェクトコンテンツルート内のすべてのファイルが含まれます。 プロジェクト ツールウィンドウ (Alt+1) では、このスコープは 製品 ビューに対応します。

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

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

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

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

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

  • クラス階層: 選択したクラスと相互接続されているクラスが含まれます。 このスコープを選択すると、階層の基本クラスを選択するように求められます。

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

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

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

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

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

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

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

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

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

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

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

新しいカラー関連付けを作成する

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

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

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

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

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

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

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

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

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

    カスタムスコープに別の色を選ぶ
  7. 変更を適用して、ダイアログを閉じます。

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

IntelliJ IDEA で色の関連付けを別の順序で処理する場合は、スコープの順序を変更できます。

スコープの順序を変更

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

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

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

スコープのユースケース

次の例は、日々の作業でスコープをどのように使用できるかを示します。

  • 特定のファイルグループだけをインスペクションする。

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

    インスペクションを実行 の詳細を参照してください。

    インスペクションスコープの指定ダイアログ
  • 検索と置換の結果を限定する。

    スコープは、 複数ファイル内検索 機能および 複数ファイル内置換 機能と組み合わせて使用でき、不要な結果を減らし、リファクタリングを高速化できます。

    プロジェクト内ターゲットの検索と置換 の詳細を参照してください。

    クラス階層で検索する
  • ナビゲーションにスコープを使用する。

    プロジェクト ツールウィンドウでは、スコープによってナビゲーションが簡単になります。 必要なスコープを選択して、今必要な項目だけの簡略ツリーを作成できます。

    プロジェクトツールウィンドウ の詳細を参照してください。

    プロジェクトツールウィンドウのスコープ
  • 特定のファイルのみを整形する。

    スコープを使うと、現在のファイルやすべてのコードベースではなく、特定のファイルだけを整形できます。 たとえば、コードを変更した後に、最近変更したファイルを整形してコードスタイルの要件に準拠させることができます。

    コードの整形 の詳細を参照してください。

    モジュールまたはディレクトリの整形ダイアログ
  • ファイルセットごとに異なるコピーライト通知を設定する。

    これはいくつかの状況で役立ちます。たとえば、プロジェクト内のファイルのコピーライト所有者が異なる場合や、サードパーティまたはオープンソースのプロジェクト由来で、元のコピーライトを維持したい場合です。

    コピーライト の詳細を参照してください。

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