スコープとファイルの色
スコープ は、プロジェクト内のファイルとフォルダーの名前付きセットです。スコープを使用すると、IDE のさまざまなビューでプロジェクト項目を視覚的に区別し、特定の操作の範囲を制限できます。
スコープを使用すると、ファイルを論理的に整理できます。たとえば、テストソースをテストスコープに配置し、本番環境のコードを本番環境スコープに配置することができます。これにより、大スコーププロジェクトでの作業が容易になります。インスペクションをテストのみで実行すると、コードベース全体で実行するよりも高速になります。
PyCharm には定義済みのスコープが付属していますが、独自のスコープを作成することもできます。カスタムスコープには、たとえば自分が担当するプロジェクトの一部のみなど、任意のファイルセットを含めることができます。
PyCharm では、スコープはコードインスペクション、一部のリファクタリング、検索、コピーライト設定、コード分析のさまざまな機能など、さまざまな機能で使用されます。
PyCharm には、ローカルと共有の 2 種類のスコープがあります。
ローカルスコープは IDE 構成ディレクトリに格納されているため、VCS を通じて共有されず、チームの他のメンバーは使用できません。
プロジェクトがバージョン管理されている場合は、共有スコープの使用が理にかなっています。VCS を使用しない場合は、ローカルスコープで十分です。
新しいスコープを定義する
PyCharm には一連の定義済みスコープがありますが、独自のスコープを定義することもできます。
Ctrl+Alt+S を押して設定を開き、を選択します。
「スコープの追加」ボタン (
) をクリックし、定義するスコープの種類 ( ローカルまたは共有) を選択します。
後で VCS で共有するチェックボックスを使用して、選択したスコープの状態(ローカルまたは共有)を変更できます。
開いたダイアログで、新しいスコープに名前を付け、OK をクリックします。
新しいスコープにファイルを追加します。プロジェクトツリーで必要な項目を選択し、ツリーの右側にあるオプションのいずれかをクリックします。
含める : 選択したアイテムを含めます。フォルダーを含める場合、このアクションはこのフォルダー内にあるファイルのみを追加します。ネストされたすべてのサブフォルダーとその内容は含まれません。
再帰的に含める : ネストされたサブフォルダーとその内容とともに、選択したフォルダーを含めます。
除外 : 選択したアイテムをスコープから除外します。フォルダーを除外する場合、このアクションはこのフォルダー内にあるファイルのみを削除します。ネストされたすべてのサブフォルダーとその内容はスコープに残ります。
再帰的に除外する : 選択したフォルダーをネストされたサブフォルダーとその内容と共に除外します。

スコープにファイルを追加すると、PyCharm は式を作成し、それをパターンフィールドに表示します。
ボタンを使用する代わりに、スコープ言語構文リファレンスを使用して、パターンフィールドにパターンを手動で入力することもできます。
変更を適用し、ダイアログを閉じます。
選択した範囲で表示されるファイルとフォルダーは、含まれているものと含まれていないものを理解するのに役立つように、さまざまな色で表示されます。
スコープに含まれるファイルとフォルダー。
除外されたファイルとフォルダーと包含されたファイルとフォルダーの両方を含むフォルダー。
選択した範囲から除外されるファイルとフォルダー。
カスタムスコープを作成すると、プロジェクトツールウィンドウと、アクションを適用するファイルの数を制限できるすべてのダイアログでそのスコープを見つけることができます。
定義済みのスコープ
PyCharm は、事前定義されたスコープのセットを提供します。IDE は、ファイルに関する情報に基づいて、これらのスコープにファイルを自動的に追加します。これらのスコープは変更できないことに注意してください。
定義済みスコープのリスト
プロジェクトファイル : プロジェクトコンテンツルート内のすべてのファイルが含まれます。詳細については、コンテンツルートを参照してください。ライブラリおよび SDK はこのスコープには含まれません。
問題 : 構文エラーのあるプロジェクトコンテンツルート内のファイルが含まれます。
開いているファイル : 現在開いているすべてのファイルが含まれます。
すべての変更ファイル : 最近変更されたすべてのファイルが含まれます。
スクラッチとコンソール : プロジェクトツールウィンドウにあるスクラッチとコンソールディレクトリのすべてのファイルが含まれます。
最近表示したファイルおよび最近変更したファイル : エディターで開いたり変更した最後の 50 個のファイルが含まれます。最近のファイルの数を変更するには、Ctrl+Alt+S を押して設定を開き、拡張設定を選択して、最近使用したファイルの最大数フィールドを検索し、希望する数を指定します。
プロジェクトとライブラリ : プロジェクトコンテンツルート内のすべてのファイルと、すべてのモジュール依存関係 (ライブラリと SDK) が含まれます。
Git によって追跡されるプロジェクトファイル : Git でバージョン管理されているプロジェクトコンテンツルート内のすべてのファイルが含まれます。
Git-Ignored を除くプロジェクトファイル : プロジェクトコンテンツルート内のすべてのファイル(Git のバージョン管理下にあるファイルとバージョン管理されていないファイルの両方)が含まれますが、
.gitignoreで指定されたファイルは除きます。プロジェクトのプロダクション用ファイル : プロジェクトコンテンツルート内のすべてのファイル(テストソースのルートを除く)が含まれます。プロジェクトツールウィンドウ(Alt+1)では、この範囲は製品ビューに対応します。
テスト : このスコープは、プロジェクトテストソースルートに限定されます。
非プロジェクトファイル : このスコープは、プロジェクトツールウィンドウのビューとしてのみ使用できます。ライブラリと SDK が含まれています。
現在のファイル : エディターで現在アクティブなファイルに対応します。
選択したファイル : ツールウィンドウで選択されたファイルが含まれます(たとえば、プロジェクトツールウィンドウ(Alt+1))。
クラス階層 : 選択したクラスと相互接続されているクラスが含まれます。このスコープを選択すると、階層の基本クラスを選択するように求められます。
ローカルの変更 (これらのスコープは、VCS 統合が有効になっているの場合に表示されます)
すべての変更ファイル : すべての変更リストから VCS にまだ追加されていない変更を含む変更されたファイルが含まれます。
デフォルト変更リスト : デフォルト変更リストから VCS にまだ追加されていない変更を含む変更されたファイルが含まれます。
「変更リスト名」 : 特定のカスタム変更リストから VCS にまだ追加されていない変更が加えられた変更済みファイルが含まれます。
データソース
コンテキストのデータソース : 現在使用しているデータソースが含まれます。コンテキストは、操作しているコンソール、データエディター、データベースエクスプローラーで選択することによって定義できます。
接続済みデータソース : アクティブな接続を持つデータソースが含まれます。
キャッシュされたデータソース : PyCharm が以前にアクセスしてキャッシュしたデータソースが含まれます。
すべてのデータソース : 追加されたすべてのデータソースが含まれます。
スコープを色に関連付ける
異なるスコープに属するファイルは、検索結果、エディタータブ、プロジェクトツールウィンドウ (Alt+1) で異なる色でハイライトできます。

各スコープに、独自の色を割り当てることができます。例: 開いているファイルスコープに色を割り当て、プロジェクトツールウィンドウにこの色を表示するように IDE を構成できます。この場合、エディターで現在作業しているファイルは、プロジェクトツリーで色分けされます。これにより、プロジェクトのナビゲーションがより速く簡単になります。ファイルの色はスコープに関連してのみ機能することに注意してください。
スコープと同様に、色の関連付けはローカルで共有できます。
ローカル色はあなただけに表示され、VCS を通じて共有されません。
新しい色の関連付けを作成する
Ctrl+Alt+S を押して設定を開き、を選択します。
ファイルカラーを有効にするチェックボックスが選択されていることを確認してから、色を使用する場所を選択します。エディタータブで使用するまたはプロジェクトビューで使用するを選択します。

プロジェクトビューで使用するチェックボックスを選択すると、プロジェクトツールウィンドウ (Alt+1) と検索結果 (たとえば、複数ファイル内検索ダイアログ Ctrl+Shift+F) に色が表示されます。
追加ボタン (
) をクリックし、色を設定するスコープを選択します。
事前定義されたスコープの 1 つを選択するか、カスタムスコープを使用できます。
必要なスコープの横にある矢印
をクリックし、開いたリストから色を選択します。
独自の色を構成するには、カスタムをクリックします。
色を編集するには、色列で必要なスコープに対応するセルをクリックし、リストから新しい色を選択します。
VCS を介して色を共有するには、VCS で共有する列の対応する行のチェックボックスを選択します。チェックボックスがオフの場合、色はローカルで使用されます。
変更を適用し、ダイアログを閉じます。
ファイルが複数のスコープに含まれている場合、スコープの順序が重要になります。PyCharm は、ローカルスコープから始めて、スコープを上から下に処理します。つまり、IDE はリスト内の最後のスコープの色をそのようなファイルに適用します。
PyCharm で色の関連付けを別の順序で処理する場合は、スコープの順序を変更できます。
スコープの順序を変更する
Ctrl+Alt+S を押して設定を開き、を選択します。
移動するスコープを選択し、上へ移動 (
) または下へ移動 (
) ボタンをクリックします。または、Alt+Up または Alt+Down を押します。
変更を適用し、ダイアログを閉じます。
スコープの使用例
次の例は、日常業務でスコープを使用する方法を示しています。
特定のファイルグループのみをインスペクションします。
スコープを使用すると、コードベースの特定の部分をインスペクションできます。たとえば、本番環境のコードをテストコードとは別にインスペクションできます。さらに、最近変更されたファイルに異なるインスペクションセットを適用することで、新しい変更がより厳密なチェックを通過するようにすることもできます。
インスペクションを実行する詳細を参照してください。

検索を制限し、結果を置き換えます。
複数ファイル内検索および複数ファイル内置換機能でスコープを使用すると、無関係な結果の数を減らし、リファクタリングを高速化できます。
プロジェクト内で検索して置き換えるの詳細を参照してください。

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

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

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

関連ページ:
IDE で使用されるディレクトリ
デフォルトでは、PyCharm は、各 IDE インスタンスのユーザー固有のファイル(構成、キャッシュ、プラグイン、ログなど)をユーザーのホームディレクトリに保存します。ただし、必要に応じて、これらのファイルを保存する場所を変更できます。IDE で使用されるファイルとディレクトリを見つけるメインメニューからを選択します。開いたダイアログには、PyCharm によって使用されるすべてのファイルとディレクトリが、現在のインストールの正確なパスとともに表示されます。リスト内の特定の項目を選択してキー...
スコープ言語構文リファレンス
スコープ言語を使用して、プロジェクトスコープ(ファイル、ディレクトリ、サブディレクトリのセット)を指定できます。ファイルのセット:単一のファイルを追加するには、ファイル名を使用します (たとえば、)、サブディレクトリのないディレクトリにすべてのファイルを追加するには、スラッシュの後にアスタリスクを使用します(たとえば:)、サブディレクトリのあるディレクトリ内のすべてのファイルを追加するには、二重スラッシュの後にアスタリスクを使用します (たとえば、)、論理演算子:スコープを定義するときは、論...
バージョン管理統合サポート
PyCharm は 2 つのレベルでバージョン管理統合をサポートします。IDE レベルでは、VCS 統合は、デフォルトで有効になっているバンドルされたプラグインのセットを通じて提供されます。プロジェクトレベルでは、プロジェクトフォルダーを 1 つまたは複数のバージョン管理システムと関連付けることで、VCS 統合が有効になります。プロジェクトルートをバージョン管理システムに関連付ける:PyCharm を使用すると、プロジェクトとバージョン管理システムの統合を迅速に有効にし、それをプロジェクトルー...
インスペクションを実行する
PyCharm は、エディターで開かれたファイル内のコードを分析し、入力時に問題のあるコードをハイライトします。さらに、選択したファイル範囲に対して必要なインスペクションまたは一連のインスペクションを手動で実行できます。この場合、ファイル内で検出されたすべての問題に関する包括的なレポートが得られます。現在のファイルの即時分析:IDE は継続的にコードをチェックし、問題を検索します。エディターの右上隅にあるウィジェットには、現在のファイルで検出された各重大度の問題の数が表示されます。ウィジェット...
プロジェクト内で検索して置き換える
プロジェクト内のテキスト文字列を検索したり、さまざまな範囲を使用して検索プロセスを絞り込んだり、検索から特定の項目を除外したり、使用箇所や出現箇所を見つけたりすることができます。プロジェクトで検索文字列を見つけるを押すか、メインメニューからを選択します。検索フィールドに検索文字列を入力します。または、エディターで検索する文字列をハイライトしてを押すか、コンテキストメニューから複数ファイル内検索を選択します。PyCharm はハイライトされた文字列を検索フィールドに入力します。以前の検索のリスト...
プロジェクトツールウィンドウ
プロジェクトツールウィンドウを使用すると、さまざまな視点からプロジェクトを確認したり、新しいアイテム(ディレクトリ、ファイル、クラスなど)の作成、エディターでのファイルのオープン、必要なコード断片への移動など、さまざまなタスクを実行したりできます。このツールウィンドウのほとんどの機能には、コンテンツペインのコンテキストメニューコマンドとして、関連するショートカットを介してアクセスします。このビューには、作成されたスクラッチファイル、クエリコンソール、拡張スクリプトを管理できるスクラッチとコンソー...