GoLand 2023.2 Help

Search and replace a target within a project

You can search for a text string within a project, use different scopes to narrow your search process, exclude certain items from your search, find usages and occurrences.

Find the search string in a project

  1. From the main menu, select Edit | Find | Find in Files Control+Shift+F.

  2. In the search field, type your search string. Alternatively, in the editor, highlight the string you want to find and press Control+Shift+F. GoLand places the highlighted string into the search field.

    To see a list of your previous searches, press Alt ArrowDown.

    To do a multi-line search, click the Multi-line search icon to enter a new line, and press Control+Alt+ArrowDown/Control+Alt+ArrowUp to browse through occurrences.

  3. Check the results in the preview area of the dialog where you can replace the search string or select another string, press Control+Shift+F again and start a new search.

  4. To see the list of occurrences in a separate tool window, click Open in Find Window. Use this window and its options to group the results, preview them, and work with them further.

    The Find in Files dialog

    If you want to see each new search result in a separate tab in the Find tool window, select the Open Results in New Tab checkbox.

Copy paths or references of the found files

  1. In the list of search results, right-click the result for which you want to copy a path and click Copy/Reference.

  2. In the Copy window, select the path or reference you need.

You can use different options in the Find in Files dialog to adjust your search process.

  • Select options such as Words (the Words icon) or Match case (the Match case icon) to find the exact word in a project or match the letter case.

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

    Escape regex symbols

    For more details on regex, refer to the search with regex documentation.

  • Click the filter icon to filter your search. For example, you can filter the search to omit comments or search only in comments instead.

  • Select one of the displayed options such as Module or Directory to limit your search.

    Moreover, you can select the Scope option that offers you a list of predefined scopes for your search.

    Limited search

    If you work without tabs, the scope Recently Viewed Files or Recently Changed Files option might become quite useful. You can also create your own custom scope, click the Browse icon (ellipsis icon) to open the Scopes dialog.

Search in the specific file types

Use the File Mask option to narrow your search to a specific file type. You can select the existing file type from the list, add a new file type, or add an additional file mask syntax to search for file types with certain patterns.

  1. In the Find in Files dialog, select the File Mask checkbox and from the list of file types, select the one you need.

    GoLand limits its search to the specified type.

  2. If you don't find the file type you need in the list, enter your file type in the File Mask field.

    Add a new file type

Replace the search string in a project

  1. Press Control+Shift+R to open the Replace in Path dialog.

  2. In the top field, enter your search string. In the bottom field, enter your replacement string.

    For example, if you want to replace a variable name with a new name for a large project, use the Replace in path instead of the Rename refactoring since your variable can appear in the config files as well.

  3. Click one of the available Replace commands.

    Replace in path dialog

Work with the search results in the Find tool window

  1. In the Find in Files dialog, click Open in Find Window to open the list of the search results in a separate window.

  2. Using icons and context menu in the Find tool window, you can sort entries, exclude directories, navigate to the source code, and so on.

    the Find tool window

    Check the following popular options:

    • If you want to exclude a directory from the results, select a directory and from the context menu, select Exclude.

    • To locate the result of the search in the editor, use the Jump to Source option from the context menu.

    • To return back to the Find in Files dialog, click the Settings icon on the left toolbar.

    • To sort the search entries, select View Options | Sort Members Alphabetically in Show Options Menu (the Show Options Menu).

    For more information on the options and icon references of the Find tool window, refer to the Find tool window reference section.

Productivity tips

Go to file

In the Find in Files dialog, select the necessary entry in the result set and press F4.

Last modified: 23 August 2023