使用箇所を検索する

コードを記述または編集するときに、変更または削除するコード要素に遭遇する場合があります。変更を行う前に、コード要素がどこで使用され、アプリケーションにどのように影響するかを確認することをお勧めします。使用箇所の検索アクションを使用すると、コードベース全体でコード要素の参照を検索できます。

検索プロセスを管理し、単一のファイルのみを検索したり、検索範囲をプロジェクト全体に拡張したり、特定の検索範囲を作成したりできます。さらに、使用箇所のハイライトの色を設定したり、使用箇所の自動ハイライトを完全に無効にしたりすることもできます。

エディターで検索したい要素をクリックすると、PyCharm はファイル内で見つかったすべての使用箇所を自動的にハイライトします。使用箇所のハイライトが無効になっている場合は、 Ctrl+Shift+F7 を押すとファイル内のすべての使用箇所がハイライトされます。
テキスト文字列を検索するには、エディターで選択し、編集 | 使用箇所の検索 | ファイル内で使用箇所の検索 Ctrl+F7 に移動します。 PyCharm はファイル内のすべての使用箇所を選択します。

ハイライトされたシンボル間を移動するには、 F3 と Shift+F3 のショートカットを使用します。

見つかった使用箇所のソースコードを表示するには、いくつかのオプションがあります。

使用箇所を検索するシンボルを選択し、シンボルを右クリックして、コンテキストメニューから使用箇所の検索を選択するか、 Alt+F7 を押します。
検索ツールウィンドウで、ソースのプレビューアイコンをクリックします。
別の方法として、見つかった使用箇所でコンテキストメニューを呼び出す場合はソースに移動を選択するか、分割して表示を選択できます。この場合、結果の使用箇所を含むファイルがエディターで開かれます。

選択したシンボルの使用箇所を別のウィンドウで表示できます。このウィンドウは、画面のさまざまな部分に移動して、クイックナビゲーションに使用できます。

エディターで、使用箇所を表示するシンボルを選択します。
Edit | Find Usages | Show Usages In Code Ctrl+Alt+F7 に進みます。
使用箇所ウィンドウには、現在のスコープと使用箇所の総数が表示されます。デフォルトのスコープにすばやく切り替えたい場合は、 Ctrl+Alt+F7 を押します。
検索結果にエントリが多すぎる場合、PyCharm は最初の 100 件の使用箇所と、ウィンドウ下部にあるさらに使用箇所オプションを表示します。このオプションをクリックするとさらに 100 件の使用箇所が表示され、検索が終了するまで繰り返されます。
ウィンドウ上部のフィルターを使用して、特定の検索エントリを表示または非表示にします。

PyCharm は使用箇所の検索の結果を記憶しているため、アクションを再度実行する必要はありません。

場合によっては、プロジェクトの特定のファイルやライブラリのみで使用箇所を見つけたい場合があります。

Ctrl+Alt+Shift+F7 を押して使用箇所の検索ダイアログを開きます。
使用箇所の検索ダイアログのスコープフィールドで、検索の範囲を選択します。例: 開いているファイルまたはプロジェクトテストファイルのみで使用箇所を検索できます。
をクリックすると、カスタムスコープも設定できる例: カスタムスコープを作成して、テストファイルなどの特定のファイルを使用箇所の検索から除外できます。新しいスコープの設定が完了したら、検索をクリックします。
PyCharm が結果を返さない場合、より多くのオプションを選択することを提案するメッセージが表示されます。
リンクをたどるか、 Ctrl+Alt+Shift+F7 を押して使用箇所の検索ダイアログを再度開き、検索の新しいスコープを設定できます。

キャレットをシンボルに置くと、IDE は現在のファイルでこのシンボルのすべての使用箇所をハイライトします。

必要に応じて、自動ハイライトを無効にすることができます。

自動ハイライトが無効になっていて、現在のファイル内のシンボルの使用箇所をハイライトする場合は、このシンボルを選択して Ctrl+Shift+F7 を押します。これにより、現在のファイル内のシンボルのすべての使用箇所がハイライトされます。

2026 年 6 月 1 日