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