PyCharm 2024.1 ヘルプ

スコープとファイルの色

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

スコープは、プロジェクト内のファイルを論理的に編成するように設計されています。テストソースはテスト関連のスコープに移動でき、製品コードは製品ファイルのスコープに関連付けることができます。これらの論理チャンクにより、プロジェクトの管理が容易になります。例: テスト関連のインスペクションをテストクラスでのみ実行すると、アプリケーション内のすべてのファイルで実行する場合よりも時間がかかりません。

PyCharm には、事前定義されたスコープのセットが付属していますが、カスタムスコープを作成することもできます。ここには、任意のファイルとフォルダーを含めることができます。例: カスタムスコープには、担当するプロジェクト内のファイルのみを含めることができます。

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

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

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

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

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

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

PyCharm には、事前定義されたスコープのセットがありますが、独自のスコープを定義することもできます。

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

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

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

  3. 開いたダイアログで、新しいスコープに名前を付け、OK をクリックします。

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

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

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

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

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

    A new scope with added files and folders

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

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

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

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

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

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

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

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

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

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

Scope highlighting in the editor tabs and search results

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

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

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

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

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

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

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

    Configure a color for the scope

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

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

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

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

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

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

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

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

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

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

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

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

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

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

関連ページ:

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

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

スコープ言語構文リファレンス

スコープ言語を使用して、プロジェクトスコープ(ファイル、ディレクトリ、サブディレクトリのセット)を指定できます。ファイルのセット:単一のファイルを追加するには、ファイル名を使用します (たとえば、)、サブディレクトリのないディレクトリにすべてのファイルを追加するには、スラッシュの後にアスタリスクを使用します(たとえば:)、サブディレクトリのあるディレクトリ内のすべてのファイルを追加するには、二重スラッシュの後にアスタリスクを使用します (たとえば、)、論理演算子:スコープを定義するときは、論...

ファイルタイプの関連付け

PyCharm は、さまざまな言語やテクノロジを表すファイルの言語固有の機能(構文のハイライトやコード分析など)について、ファイルタイプのリストを保持します。各ファイルタイプは、言語サービスを 1 つ以上のファイル名パターンにリンクします。ファイルタイプのデフォルトリストには、関連するすべてのファイル名パターンが含まれていますが、カスタム言語ファイルに新しいファイルタイプを追加したり、既存のファイルタイプに関連付けられたファイル名パターンを変更したりできます。エディターでファイルを開くと、PyC...

IDE 設定を共有する

PyCharm を使用すると、異なる PyCharm インストール間、または使用している異なる IntelliJ ベースの IDE 製品間で IDE 設定を共有できます。これにより、異なるコンピューターで作業している場合に快適な作業環境を再現でき、慣れているものと見た目や動作が異なるという煩わしさを回避できます。IDE 設定を共有するには、いくつかの方法があります。設定の同期プラグイン経由:JB アカウントを使用し、そのアカウントでログインしているすべての IDE で同期された設定を利用できるよ...