スコープとファイルの色
スコープ 
は、project 内のファイルとフォルダーの名前付きセットです。 スコープを使用すると、IDE のさまざまなビューで project の項目を 視覚的に区別し 、特定の操作の範囲を制限できます。
スコープを使用すると、ファイルを論理的に整理できます。 たとえば、テストソースをテストスコープに配置し、本番環境のコードを本番環境スコープに配置することができます。 これにより、大規模な projects での作業が容易になります。 インスペクションをテストのみで実行すると、コードベース全体で実行するよりも高速になります。
WebStorm には 事前定義されたスコープのセットが付属していますが、独自のスコープを作成することもできます。 カスタムスコープには、例えば自分が担当する project の一部のみのように、任意のファイルセットを含めることができます。
WebStorm では、スコープはコードインスペクション、一部のリファクタリング、検索、コピーライト設定、コード解析など、 さまざまな機能で使用されます。
WebStorm には、ローカルと共有のスコープがあります。
ローカルスコープ は IDE 構成ディレクトリに格納されているため、VCS を通じて共有されず、チームの他のメンバーは使用できません。
project が バージョン管理下にある場合、共有スコープの使用は理にかなっています。 VCS を使用しない場合は、ローカルスコープで十分です。
新しいスコープを定義する
WebStorm には一連の 定義済みスコープがありますが、独自のスコープを定義することもできます。
Ctrl+Alt+S を押して設定を開き、 を選択します。
「スコープの追加 」ボタン (
) をクリックし、定義するスコープの種類 (ローカルまたは 共有) を選択します。
後で VCS で共有する チェックボックスを使用して、選択したスコープの状態（ローカルまたは共有）を変更できます。
開いたダイアログで、新しいスコープに名前を付け、 OK をクリックします。
新しいスコープにファイルを追加します。 project ツリーで必要な項目を選択し、ツリーの右側にあるオプションのいずれかをクリックします：
含める: 選択したアイテムを含めます。 フォルダーを含める場合、このアクションはこのフォルダー内にあるファイルのみを追加します。 ネストされたすべてのサブフォルダーとその内容は含まれません。
再帰的に含める: ネストされたサブフォルダーとその内容とともに、選択したフォルダーを含めます。
除外: 選択したアイテムをスコープから除外します。 フォルダーを除外する場合、このアクションはこのフォルダー内にあるファイルのみを削除します。 ネストされたすべてのサブフォルダーとその内容はスコープに残ります。
再帰的に除外する: 選択したフォルダーをネストされたサブフォルダーとその内容と共に除外します。
スコープにファイルを追加すると、WebStorm は式を作成し、それを パターン フィールドに表示します。
ボタンを使用する代わりに、 パターン フィールドに スコープ言語構文リファレンスを参照して、パターンを手動で入力することもできます。
例: すでに縮小されたファイルの縮小を回避するには、
file:*js&&!file:*.min.*パターンでカスタムスコープを構成します。
変更を適用し、ダイアログを閉じます。
選択したスコープで表示されるファイルとフォルダーは、含まれているものと含まれていないものを把握しやすいように、さまざまな色で表示されます：
スコープに含まれるファイルとフォルダー。
除外されたファイルとフォルダーと包含されたファイルとフォルダーの両方を含むフォルダー。
選択した範囲から除外されるファイルとフォルダー。
カスタムスコープを作成すると、 プロジェクト ツールウィンドウと、アクションを適用するファイルの数を制限できる すべてのダイアログでそのスコープを見つけることができます。
定義済みスコープ
WebStorm は、事前定義されたスコープのセットを提供します。 IDE は、ファイルに関する情報に基づいて、これらのスコープにファイルを自動的に追加します。 これらのスコープは変更できないことに注意してください。
定義済みスコープのリスト
プロジェクトファイル ：project コンテンツルート内のすべてのファイルが含まれます。 プロジェクト構造の構成 の詳細をご覧ください。 ライブラリとフレームワークはこのスコープには含まれません。
問題 ：構文エラーのある project コンテンツルート内のファイルが含まれます。
すべての変更ファイル: 最近変更されたすべてのファイルが含まれます。
スクラッチとコンソール: プロジェクト ツールウィンドウにある スクラッチとコンソール ディレクトリのすべてのファイルが含まれます。
最近表示したファイル および 最近変更したファイル: エディターで開いたり変更した最後の 50 個のファイルが含まれます。 最近のファイルの数を変更するには、 Ctrl+Alt+S を押して設定を開き、 拡張設定 を選択して、 最近使用したファイルの最大数 フィールドを検索し、希望する数を指定します。
Git によって追跡されるプロジェクトファイル ：Git でバージョン管理されている project コンテンツルート内のすべてのファイルが含まれます。
Git-Ignored を除くプロジェクトファイル ：project コンテンツルート内のすべてのファイル（Git のバージョン管理下にあるファイルとバージョン管理されていないファイルの両方）が含まれますが、
.gitignoreで指定されたファイルは除きます。テスト ：このスコープは project テストソースルートに限定されます。
開いているファイル: 現在エディターで開いているファイルが含まれます。
現在のファイル: エディターで現在アクティブなファイルに対応します。
選択したファイル: ツールウィンドウで選択されたファイルが含まれます（たとえば、 プロジェクト ツールウィンドウ（Alt+1））。
ローカルの変更 (これらのスコープは、 VCS 統合が有効になっているの場合に表示されます)
すべての変更ファイル: すべての変更リストから VCS にまだ追加されていない変更を含む変更されたファイルが含まれます。
デフォルト変更リスト: デフォルト 変更リストから VCS にまだ追加されていない変更を含む変更されたファイルが含まれます。
「変更リスト名」: 特定のカスタム変更リストから VCS にまだ追加されていない変更が加えられた変更済みファイルが含まれます。
データソース
コンテキストのデータソース: 現在使用しているデータソースが含まれます。 コンテキストは、操作しているコンソール、データエディター、データベースエクスプローラーで選択することによって定義できます。
接続済みデータソース: アクティブな接続を持つデータソースが含まれます。
すべてのデータソース: 追加されたすべてのデータソースが含まれます。
スコープを色に関連付ける
異なるスコープに属するファイルは、検索結果、エディタータブ、 プロジェクト ツールウィンドウ (Alt+1) で異なる色でハイライトできます。
各スコープに、独自の色を割り当てることができます。 例: 開いているファイル スコープに色を割り当て、 プロジェクト ツールウィンドウにこの色を表示するように IDE を構成できます。 この場合、エディターで現在作業しているファイルは、プロジェクトツリーで色分けされます。 これにより、project のナビゲーションがより速く簡単になります。 ファイルの色はスコープに関連してのみ機能することに注意してください。
スコープと同様に、色の関連付けは ローカルで 共有できます。
ローカル色 はあなただけに表示され、VCS を通じて共有されません。
新しい色の関連付けを作成する
Ctrl+Alt+S を押して設定を開き、 を選択します。
ファイルカラーを有効にする のチェックボックスが選択されていることを確認してから、色を使用する場所を選択します： エディタータブで使用する または プロジェクトビューで使用する を選択します。
プロジェクトビューで使用する チェックボックスを選択すると、 プロジェクト ツールウィンドウ (Alt+1) と検索結果 (たとえば、 ファイル内検索 ダイアログ Ctrl+Shift+F) に色が表示されます。
追加 ボタン (
) をクリックし、色を設定するスコープを選択します。事前定義されたスコープの 1 つを選択するか、 カスタムスコープを使用できます。
必要なスコープの横にある矢印
をクリックし、開いたリストから色を選択します。独自の色を構成するには、 カスタム をクリックします。
色を編集するには、 色 列で必要なスコープに対応するセルをクリックし、リストから新しい色を選択します。
VCS を介して色を 共有するには、 VCS で共有する 列の対応する行のチェックボックスを選択します。 チェックボックスがオフの場合、色は ローカルで使用されます。
変更を適用し、ダイアログを閉じます。
ファイルが複数のスコープに含まれる場合、スコープの順序が重要になります。WebStorm はローカルスコープから順番に上から下へスコープを処理します。 つまり、そのようなファイルにはリスト内で最後のスコープの色が適用されます。
WebStorm で色の関連付けを別の順序で処理したい場合は、スコープの順序を変更できます。
スコープの順序を変更する
Ctrl+Alt+S を押して設定を開き、 を選択します。
移動するスコープを選択し、 上へ移動 (
) または 下へ移動 (
) ボタンをクリックします。 または、 Alt+Up または Alt+Down を押します。変更を適用し、ダイアログを閉じます。
スコープの使用例
次の例は、日常業務でスコープを使用する方法を示しています。
特定のファイルグループのみをインスペクションします。
スコープを使用すると、コードベースの特定の部分をインスペクションできます。 たとえば、本番環境のコードをテストコードとは別にインスペクションできます。 さらに、最近変更されたファイルに異なるインスペクションセットを適用することで、新しい変更がより厳密なチェックを通過するようにすることもできます。
詳細は インスペクションを実行する をご覧ください。
検索を制限し、結果を置き換えます。
ファイル内検索 および ファイル内置換 機能でスコープを使用すると、無関係な結果の数を減らし、リファクタリングを高速化できます。
詳細は プロジェクト内のターゲットを検索 をご覧ください。
ナビゲーションにはスコープを使用します。
プロジェクト ツールウィンドウでは、スコープを使用してナビゲーションを簡素化することもできます。 必要なスコープを選択することで、現在必要な項目のみを含む簡素化されたツリーを作成できます。
詳細は プロジェクトツールウィンドウ をご覧ください。
特定のファイルのみを再フォーマットします。
スコープを使用すると、現在のファイル、選択したフォルダー、コードベース全体だけでなく、特定のファイルのみを再フォーマットできます。 たとえば、コードに変更を加えた後、最近変更されたファイルを再フォーマットして、コードスタイルの要件に準拠させることができます。
詳細は コードの整形 をご覧ください。
異なるファイルセットごとに異なるコピーライト表示を設定します。
これは、プロジェクト内のファイルに異なるコピーライト所有者がいる場合や、サードパーティまたはオープンソースプロジェクトからのファイルで、元のコピーライトを保持したい場合など、さまざまな状況で役立ちます。
詳細は コピーライト をご覧ください。
