PyCharm 2024.1 ヘルプ

スコープ

スコープ the Scope icon は、プロジェクト内のファイル、パッケージ、ディレクトリのサブセットであり、検索コードインスペクションなどの特定の操作の適用を制限できます。さらに、各スコープの色分けを設定して、どのような種類のファイルを扱っているかを一度に確認できます。

プロジェクトが大きくなるにつれて、スコープはさらに役立ちます。基本的なケースをカバーするいくつかの定義済みスコープがあります。さらに、プロジェクトにカスタムスコープを追加することも可能です。例: テスト用またはチーム内で担当しているファイル用にカスタムスコープを作成できます。

スコープの種類

スコープは共有またはローカルのどちらでもかまいません。

  • ローカルスコープは個人使用のみを目的としており、ワークスペースの .ideaworkspace.xml ファイルに保存されます。

    .

  • 共有スコープは、VCS を介してチームメンバーがアクセスでき、プロジェクトレベルで .ideascopes ディレクトリに、.xml 拡張子を持つファイル、つまり .idea/scopes/<scope_name>.xml として保存されます。

設定ダイアログ (Ctrl+Alt+S) の外観 & 振る舞い | スコープページにあるプロジェクトファイルとして保存チェックボックスを使用すると、ローカルスコープをすばやく共有する (または共有スコープをローカルにする) ことができます。スコープの管理の詳細については、「スコープとファイルの色」を参照してください。

スコープの定義

PyCharm には、スコープに含まれるエンティティのセットを柔軟に定義するための特別な言語が用意されています。

詳細は、スコープ言語構文リファレンスを参照してください。

スコープを作成および編集するには、設定ダイアログスコープページを使用します。

スコープは次のモードで定義されます。

  • 手動で、パターンフィールドのスコープ言語構文に従ってファイルマスクを指定します。

  • ファイルとフォルダーを選択し、ボタン包含再帰的に含める除外再帰的に除外するをクリックします。包含 / 除外に基づいて、PyCharm は式を作成し、それをパターンに表示します。

    詳細は、スコープとファイルの色を参照してください。

使用可能なスコープを表示するには、the Down icon プロジェクトツールウィンドウプロジェクトヘッダーの横にある)をクリックします。

Scopes in the Project tool window

スコープの色付け

異なるスコープに属するファイルは、PyCharm のユーザーインターフェース全体(ナビゲーションリスト、エディタータブ、プロジェクトツールウィンドウ)で異なる色でハイライトできます。これにより、大スコーププロジェクトでのナビゲーションがはるかに高速で簡単になります。

Scope highlighting in the editor tabs and search results

いくつかのファイルが複数のスコープに含まれている場合、スコープの順序が重要になります。PyCharm は、そのようなファイルをハイライトするために一番上のスコープの色(スコープ設定ページに表示)を使用します。もちろん、スコープの順序、つまり結果のハイライトを変更することができます。

スコープの順序とスコープと色の関連付けの構成の詳細については、「スコープとファイルの色」を参照してください。

定義済みのスコープ

PyCharm にはいくつかの事前定義されたスコープが用意されています。

  • プロジェクトファイル。このスコープには、プロジェクトコンテンツルート内のすべてのファイルが含まれます ( コンテンツルートを参照)。通常、外部ライブラリはこの範囲に含まれません。

  • 問題。このスコープには、構文エラーが見つかったプロジェクトコンテンツルート内のファイルが含まれます。

  • 開いているファイル。このスコープは、PyCharm エディターで開かれたファイルに対応します。

  • スクラッチとコンソール。この範囲には、プロジェクトのスクラッチファイルとコンソールのコンテンツが含まれます。

定義済みのスコープは編集できません。

関連ページ:

プロジェクト内で検索して置き換える

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

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

PyCharm は、エディターで開かれたファイル内のコードを分析し、入力時に問題のあるコードをハイライトします。さらに、選択したファイル範囲に対して必要なインスペクションまたは一連のインスペクションを手動で実行できます。この場合、ファイル内で検出されたすべての問題に関する包括的なレポートが得られます。現在のファイルの即時分析:IDE は継続的にコードをチェックし、問題を検索します。エディターの右上隅にあるウィジェットには、現在のファイルで検出された各重大度の問題の数が表示されます。ウィジェット...

スコープとファイルの色

スコープは、プロジェクト内のファイルとフォルダーのグループです。スコープを使用して、さまざまな IDE ビューでプロジェクト項目を視覚的に区別し、特定の操作の範囲を制限できます。スコープは、プロジェクト内のファイルを論理的に編成するように設計されています。テストソースはテスト関連のスコープに移動でき、製品コードは製品ファイルのスコープに関連付けることができます。これらの論理チャンクにより、プロジェクトの管理が容易になります。例: テスト関連のインスペクションをテストクラスでのみ実行すると、アプリ...

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

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

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

プロジェクトツールウィンドウでは、様々な視点からプロジェクトを見て、新しいアイテム(ディレクトリ、ファイル、クラスなど)の作成、エディターでのファイルのオープン、必要なコードフラグメントへの移動など、様々なタスクを実行することができます。このツールウィンドウのほとんどの機能には、コンテンツペインのコンテキストメニューコマンドとして、関連するショートカットを介してアクセスします。また、ビューには、作成されたスクラッチファイル、クエリコンソール、拡張スクリプトを管理できるスクラッチとコンソールフォル...

名前でターゲットを検索する (どこでも検索)

プロジェクト内またはプロジェクト外のアイテムは、その名前で見つけることができます。単一のエントリポイントから、Git 内のファイル、アクション、クラス、シンボル、設定、UI 要素などを検索できます。この機能の使用方法については、次のビデオを参照してください。プロジェクト内のテキストの検索の詳細については、「ファイル内で検索して置き換える」を参照してください。どこでも検索メインメニューで、に移動するか、を 2 回押して検索ウィンドウを開きます。デフォルトでは、PyCharm は最近使用したファイ...