Find and replace in file

1. Open your file in the editor.

2. Press Ctrl0F or select Edit | Find | Find from the main menu.

   note

   If you want to extend the search of your target beyond the current file, press CtrlShift0F. For more information, refer to Find and replace in project.

3. In the search field that opens, enter your search string. PyCharm highlights the results of your search in the file. Alternatively, in the editor, highlight the string you want to find and press Ctrl0F. PyCharm places the highlighted string into the search field.

   

   note

   Place a caret at any string in your file and press Ctrl0F to find its occurrences or go to Edit | Find | Next Occurrence of the Word at Caret.

You can search for a text string inside the multi-line selection.

note

PyCharm handles replacing in the multi-line selection the same way.

1. Select a multi-line fragment and press Ctrl0F.

2. Click and type your search string. PyCharm will search for the target inside the selected fragment first.

   If you release , PyCharm will switch the search process back to the whole file.

   If you want to search for the multi-line fragment itself, select it and press Ctrl0F.

PyCharm lets you adjust your search process and perform various actions with the displayed search results.

• If you want to see the list of previous searches, press ⌥↓ in the search field.

  

• If you want to enter a multi-line string, click the icon in the search field for a new line.

• With selected, PyCharm automatically escapes special regex symbols with backslash \ when you search for a text string that contains them.

  note

  Keep in mind that if you copy (Ctrl0C) the string first and then paste (Ctrl0V) it in the search field, the regex symbols will not be taken into account.

  For more information about regex, refer to the search with regex documentation.

• Use the and arrows to navigate to the previous or the next occurrence.

• Work with the list of occurrences AltF7 in the Find tool window, where you have other options, for example, to group your results or to open them in a separate window.

  

• Click the or icon to add a selection of the next occurrence or deselect the previous occurrence Alt0J or AltShift0J.

• If you want to quickly replace the target of your search in the whole file, press CtrlAltShift0J and type a new string.

  

  Gif

• You can narrow your search when you click , in the search field, or click to select a scope for your search.

• You can press ^⌥X (previously known as ⌥G) to quickly toggle the Regex option. You can use regular expressions to opt for more challenging searches.

• Press CtrlF7 to see usages of any element in the opened file.

  If you don't want PyCharm to highlight all found usages in the file, open the Settings dialog (CtrlAlt0S) and on the Editor | General page clear the Highlight usages of element at caret option.

  Press AltF7 to search for usages beyond the current file or CtrlAltF7 to open the search results in a separate popup. If you need to configure some options before the search, press CtrlAltShiftF7 to open the Find Usages dialog.

For more information about replacing all discovered occurrences in the entire project, refer to Find and replace in project.

1. Press Ctrl0R or select Edit | Find | Replace from the main menu to open the Replace in File window.

2. In the top field, enter your search string. In the bottom field, enter your replacement string. If you need to preserve the case, click located in the replace field.

   

   Click for a multi-line replace. For example, if you want to replace a comma with a comma and a new line, enter a comma in the search field and a comma and the new line in the replace field.

3. Click Replace to replace items one by one, Replace all to replace all items in your file, and Exclude to omit some items from replacing.

The options that appear in the Replace window, are similar to the Find window and you can refer to the manage the search results section.