IntelliJ IDEA 2025.3 ヘルプ

スコープとファイルの色

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

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

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

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

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

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

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

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

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

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

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

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

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

    Creating a new scope: selecting between a shared and a local scope
  3. 開いたダイアログで、新しいスコープに名前を付け、OK をクリックします。

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

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

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

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

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

    A new scope with added files and folders

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

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

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

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

  • the green color sample スコープに含まれるファイルとフォルダー。

  • the dark blue color sample 除外されたファイルとフォルダーと包含されたファイルとフォルダーの両方を含むフォルダー。

  • the black color sample 選択した範囲から除外されるファイルとフォルダー。

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

The new scope shown in the Project tool window

定義済みのスコープ

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 で異なる色でハイライトできます。

Scope highlighting in the editor tabs and search results

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

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

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

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

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

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

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

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

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

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

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

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

    Selecting a color for a custom scope
  5. 色を編集するには、列で必要なスコープに対応するセルをクリックし、リストから新しい色を選択します。

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

    Picking another color for a custom scope
  7. 変更を適用し、ダイアログを閉じます。

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

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

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

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

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

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

スコープの使用例

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

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

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

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

    The Specify Inspection Scope dialog
  • 検索を制限し、結果を置き換えます。

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

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

    Search in class hierarchy
  • ナビゲーションにはスコープを使用します。

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

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

    Scopes in Project tool window
  • 特定のファイルのみを再フォーマットします。

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

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

    Module or directory reformat dialog
  • 異なるファイルセットごとに異なるコピーライト表示を設定します。

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

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

    Associating a profile with a scope
2026 年 1 月 06 日

関連ページ:

IDE で使用されるディレクトリ

デフォルトでは、IntelliJ IDEA は、各 IDE インスタンスのユーザー固有のファイル(構成、キャッシュ、プラグイン、ログなど)をユーザーのホームディレクトリに保存します。ただし、必要に応じて、これらのファイルを保存する場所を変更できます。IDE ディレクトリの場所を変更するたとえば、ユーザープロファイルドライブの容量が不足している場合や低速ディスクにある場合、ホームディレクトリが暗号化されている(IDE の速度が低下している)場合、またはネットワークドライブにある場合は、デフォルトの...

コンテンツルート

IntelliJ IDEA のコンテンツは、ソースコード、ビルドスクリプト、テスト、ドキュメントを含むファイルのグループです。これらのファイルは通常、階層構造になっています。最上位フォルダーはコンテンツルートと呼ばれます。モジュールには通常、1 つのコンテンツルートがあります。コンテンツルートを追加することができます。たとえば、コードがコンピューター上の別の場所に格納されている場合には、これは便利です。同時に、モジュールはコンテンツルートなしで存在することができます。この場合、他のモジュールの依...

バージョン管理統合サポート

IntelliJ IDEA は 2 つのレベルでバージョン管理統合をサポートします。IDE レベルでは、VCS 統合は、デフォルトで有効になっているバンドルされたプラグインのセットを通じて提供されます。プロジェクトレベルでは、プロジェクトフォルダーを 1 つまたは複数のバージョン管理システムと関連付けることで、VCS 統合が有効になります。プロジェクトルートをバージョン管理システムに関連付ける:IntelliJ IDEA を使用すると、プロジェクトとバージョン管理システムの統合を迅速に有効にし...

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

IntelliJ IDEA は、エディターで開かれたファイル内のコードを分析し、入力時に問題のあるコードをハイライトします。さらに、選択したファイルの範囲に対して必要なインスペクションまたは一連のインスペクションを手動で実行できます。この場合、ファイル内で検出されたすべての問題に関する包括的なレポートが得られます。インスペクションを手動で実行する:いくつかのインスペクションはグローバルコード分析を必要とし、それらがエディターで無効にされる理由です。これらのインスペクションはにリストされています...

プロジェクト内のターゲットを検索および置換する

プロジェクト内でテキスト文字列を検索したり、さまざまなスコープを使用して検索プロセスを絞り込んだり、出現箇所を見つけたり、特定のアイテムを検索から除外したりできます。プロジェクトで検索文字列を見つけるを押すか、メインメニューからを選択します。検索フィールドに検索文字列を入力します。または、エディターで検索する文字列をハイライトしてを押すか、コンテキストメニューから複数ファイル内検索を選択します。IntelliJ IDEA はハイライトされた文字列を検索フィールドに入力します。以前の検索のリスト...

プロジェクトツールウィンドウ

プロジェクトツールウィンドウを使用すると、さまざまな視点からプロジェクトを確認し、新しい項目 (ディレクトリ、ファイル、クラスなど) の作成、エディターでのファイルのオープン、必要なコードフラグメントへの移動などのさまざまなタスクを実行できます。ビュー:ツールウィンドウにはいくつかのビューがあります。プロジェクトビュー。このビューには、すべてのプロジェクト項目とその依存関係 (SDK とライブラリ) が表示されます。パッケージも表示されますが、ディレクトリ構造に重点が置かれています。パッケー...