GoLand
 
2025.1EAP
Shortcuts: Windows
Get GoLand
Because GoLand 2025.1 is still in development, this documentation may not be entirely accurate and is subject to change.
  1. Write and edit source code
  2. Code refactoring
  3. Rename refactorings

Rename refactorings

Last modified: 07 February 2025

Shortcut: ShiftF6

Main menu: Refactor | Rename

Context menu: Rename

General refactoring settings: Settings | Editor | Code Editing

Use the Rename refactoring to change names of symbols, files, and all the references to them throughout code.

Renaming local variables or private methods can be done easily inline since only the limited scope is affected. Renaming types, interfaces, or public methods could potentially impact a lot of files. Preview potential changes before you refactor.

tip

When you rename methods that are declared in interfaces, you can also review and rename their implementations as well. The refactoring changes are displayed on the Refactoring Preview tab in the Find tool window.

Rename code in place

  1. In the editor start renaming a parameter, a method, or other code element. GoLand will display the Rename the usages of icon in the gutter.

  2. Click the gutter icon or press AltEnter and apply a suggestion.

    Rename inline

    GoLand renames the code element and updates its usages accordingly.

    Rename refactoring result

Rename code in place with inlay hint

  1. In the editor, find the code element you want to rename.

  2. Edit the text of the code element you want to rename, GoLand will display the Rename usages inlay hint.

  3. Select the inlay hint.

    Go code element renamed

Rename a code element

  1. In the editor, select the element you want to rename. If you need to rename a file, select one in the Project tool window.

  2. Press ShiftF6 or right-click and select Rename from the context menu.

    When you invoke the rename ShiftF6 action, GoLand displays the Rename in comments and strings icon and the Rename in text occurrences icon next to the highlighted element.

    Rename variable

    You can press CtrlAltShift0N to open the context menu and select the additional rename options.

    Additional Rename options

    If you want to see the Rename dialog with more options, click the More options link or press ShiftF6.

  3. You can perform the rename refactoring in-place or press ShiftF6 again to open the Rename dialog. Enter a new name of the element to enable the Preview and Refactor buttons.

    The Rename dialog

    You can specify additional options. For example, specify where to search for element occurrences, or what else to rename. You can also specify a scope for the refactoring.

  4. In the Refactoring Preview dialog, review potential changes and click Refactor.

The refactoring dialog

Next time you invoke the Rename refactoring, GoLand remembers the options you have specified inside the Rename dialog.

note

You cannot rename the .idea project directory since GoLand always reads the project files from the directory with that exact name.

tip

If you need to edit variables rather than to change them completely, go to Settings | Editor | Code Editing and clear the Preselect current symbol name for Rename refactoring checkbox located in the Refactorings section.

Rename methods in interfaces

You can rename methods that are declared in interfaces. When you rename the method, GoLand displays a context menu where you can select to rename method implementations as well.

  1. Right-click a method in an interface and select Refactor | Rename. Alternatively, place the caret at the method in the interface and press ShiftF6.

  2. In context menu select what you want to rename. To rename the method and all implementations, select Refactor method specification and all implementations. Otherwise, to refactor only selected method, select Refactor only current method.

  3. In the Change Signature dialog, change the method name in the Name field.

  4. Click Refactor.

    To preview your changes before refactoring, click Preview.

Rename methods in interfaces

Rename packages

  1. Click the module name and navigate to Refactor | Rename. Alternatively, press ShiftF6.

  2. In the Rename dialog, configure the renaming options and click Refactor. Alternatively, click Preview to check all the usages of the module name in the project.

    Rename Go modules names