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

プロジェクトで検索文字列を見つける

1. Ctrl+Shift+F を押すか、メインメニューから編集 | 検索 | 複数ファイル内検索を選択します。

2. 検索フィールドに検索文字列を入力します。または、エディターで検索する文字列をハイライトして Ctrl+Shift+F を押すか、コンテキストメニューから複数ファイル内検索を選択します。PyCharm はハイライトされた文字列を検索フィールドに入力します。

   以前の検索のリストを表示するには、Alt+Down を押します。

   必要に応じて、追加のオプションを指定します。

   

   PyCharm は、検索文字列と含むファイルをリストします。検索文字列が同じコード行で複数回見つかった場合、PyCharm は結果を 1 行にマージします。

   複数行検索を行うには、 アイコンをクリックして新しい行を入力し、Ctrl+Alt+Down/Ctrl+Alt+Up を押して出現箇所を参照します。

3. 検索文字列を置き換えるか、別の文字列を選択するか、Ctrl+Shift+F をもう一度押して新しい検索を開始するダイアログのプレビュー領域で結果を確認します。

4. 出現箇所のリストを別のツールウィンドウに表示するには、検索ウィンドウで開くをクリックします。このウィンドウとそのオプションを使用して、結果をグループ化し、プレビューし、さらに操作します。

   新しい検索結果をそれぞれ検索ツールウィンドウの個別のタブに表示する場合は、複数ファイル内検索ダイアログの下部にある結果を新規タブで開くチェックボックスを選択します。

見つかったファイルのパスまたは参照をコピーする

1. 検索結果のリストで、パスをコピーする結果を右クリックし、コピー / 参照をクリックします。

2. コピーウィンドウで、必要なパスまたは参照を選択します。

検索を絞り込む

複数ファイル内検索ダイアログでは、さまざまなオプションを使用して検索プロセスを調整できます。

• 単語（）または大 / 小文字を区別する（）などのオプションを選択して、プロジェクト内の正確な単語を検索するか、大文字と小文字を一致させます。

• が選択されている場合、PyCharm は、含むテキスト文字列を検索するときに、バックスラッシュ \ で特殊な正規表現記号を自動的にエスケープします。

  regex の詳細については、regex を使用した検索のドキュメントを参照してください。

• 検索をフィルタリングするには、 アイコンをクリックします。例: 検索をフィルタリングして、コメントを省略したり、コメント内でのみ検索したりすることができます。

• 検索を制限するには、モジュールまたはディレクトリなどの表示されたオプションのいずれかを選択します。

  さらに、検索用のリストを提供するスコープオプションを選択することもできます。たとえば、プロジェクトで開いているファイルのみに検索を制限できます。

  

  タブなしで作業する場合は、スコープ最近表示したファイルまたは最近変更したファイルオプションが役立つ場合があります。独自のカスタムスコープを作成することもできます。参照アイコン () をクリックして、スコープダイアログを開きます。

特定のファイルタイプで検索する

ファイルマスクオプションを使用して、検索を特定のファイルタイプに絞り込みます。リストから既存のファイルタイプを選択したり、新しいファイルタイプを追加したり、追加のファイルマスク構文を追加して、特定のパターンのファイルタイプを検索することができます。

1. 編集 | 検索 | 複数ファイル内検索 Ctrl+Shift+F に進みます。

2. 複数ファイル内検索ダイアログでファイルマスクチェックボックスを選択し、ファイルタイプのリストから必要なものを選択します。

   

   PyCharm はその検索を指定されたタイプに制限します。

3. リストに必要なファイルタイプが見つからない場合は、ファイルタイプをファイルマスクフィールドに入力します。

   検索フィールドにファイルマスクを手動で追加できます。必要に応じて、コンマで区切っていくつかのファイルタイプを指定します。

プロジェクトの使用箇所を検索する

プロジェクト全体または設定した範囲内のシンボルの使用箇所を検索できます。

1. 編集 | 検索 | 複数ファイル内検索 Ctrl+Shift+F に進みます。

2. 使用箇所を見つけたいシンボルを選択します。ファイル検索にも検索を拡張できることに注意してください。

3. メインメニューで、編集 | 検索 | 使用箇所の検索 Alt+F7 に移動します。

4. 検索ツールウィンドウで結果を確認します。

   

   以前の使用箇所の検索アクションから結果をプルすることもできます。編集 | 検索 | 最近の使用箇所を検索と使用箇所のクエリに移動します。

   検索ツールウィンドウでは、プレビュー領域を使用して、使用箇所が検出された場所を確認したり、メソッドの呼び出し階層を表示したり、フィールドのデータフローなどを表示することができます。

   

   PyCharm が結果を返さない場合は、より多くのオプションを選択するように指示するメッセージが表示されます。リンクをたどったり、Ctrl+Alt+Shift+F7 を押して使用箇所の検索ダイアログを開いて、新しい検索範囲を設定することができます。

   

   例: 検索範囲を実動ファイルのみに設定することも、ファイルを開くだけに設定することもできます。

   カスタムスコープを設定するには、 をクリックします。

5. 新しいスコープの設定が完了したら、検索をクリックします。

別のウィンドウで選択したシンボルの使用箇所を PyCharm に表示させたい場合は、Ctrl+Alt+F7 を押します。このウィンドウを使用すると、すばやく移動できます。

同じショートカットをもう一度押して、デフォルトスコープでその用途を確認します。

使用箇所の自動ハイライトを無効にする

キャレットをシンボルに置くと、IDE は現在のファイルでこのシンボルのすべての使用箇所をハイライトします。ハイライトされたシンボル間を移動するには、F3 と Shift+F3 のショートカットを使用します。

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

• 設定ダイアログ (Ctrl+Alt+S) で、エディター | 一般に移動し、キャレット上の要素の使用箇所をハイライトするチェックボックスをオフにします。

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

プロジェクトの検索文字列を置き換える

1. Ctrl+Shift+R （編集 | 検索 | パス内置換）を押して、パス内置換ダイアログを開きます。

2. 上部のフィールドに検索文字列を入力します。下部のフィールドに、置換文字列を入力します。

   

   例: 大規模なプロジェクトで変数名を新しい名前に置き換える場合は、変数が構成ファイルにも表示される可能性があるため、名前変更リファクタリングの代わりにパス内置換を使用します。

3. 使用可能な置換コマンドのいずれかをクリックします。