プロジェクト内のターゲットを検索および置換する

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

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

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

検索を絞り込む

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

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

• が選択されている場合、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. 使用可能な置換コマンドのいずれかをクリックします。