GoLand 2024.1 Help

Intention actions

As you work in the editor, GoLand analyzes your code, searches for ways to optimize it, and detects potential and actual problems. Intention actions cover a wide range of situations from errors and warnings to optimization suggestions.

In GoLand, you can use the following types of intention actions:

  • Intention actions yellow bulb icon: an action that generates a piece of code or suggests an alternative variant for your code. Usually, an intention action is applied to a valid piece of code. By clicking the yellow bulb icon, you can view intention actions available in the current context. For example, you can create a constructor that generates values of a struct type. Or, replace the if-else statement with the equivalent one but with a negated condition and swapped if-else branches.

  • Quick-fixes red bulb icon: an action that suggests a solution for a problem in your code. Usually, the intention action is applied to a code that has an error. For example, when you missed brackets at the end of the expression. Or, when you forgot to convert a value to a specific type.

Apply intention actions

  1. Place the caret at the code element that you want to modify. Then click the light bulb icon (or press Alt+Enter) to open the list of suggestions.

    Intention preview opens automatically. If an intention is complex, and the preview cannot be generated, you will see the intention description. hover over available intentions on the suggestion list to preview them.

  2. Press Enter or click an intention on the list to apply it.

    Inject a language with the intention action

You can toggle the preview off and on by pressing Ctrl+Q or by enabling Show preview for intention actions when available in Settings (Ctrl+Alt+S) | Editor | General | Appearance.

Assign a shortcut to an intention

If you want to apply intention actions quicker, you can assign shortcuts to them. Currently, you cannot assign shortcuts to fixes that belong to code inspections.

  1. In the editor, place the caret at the code that triggers the intention action for which you want to assign a shortcut, and click the bulb icon or press Alt+Enter.

    A list of available suggestions opens.

  2. In the list, click next to the necessary intention action and, from the menu that opens, select Assign shortcut.

    Assigning keyboard shortcut to intention action
  3. When the Keyboard Shortcut dialog opens, press the shortcut that you want to use for this action and click OK.

After that you won't need to open the list of suggestions to apply this intention action in the editor; you will be able to do it right away by pressing the configured shortcut.

You can find all your custom intention action shortcuts in settings: press Ctrl+Alt+S, click Keymap, and locate the Intentions category.

View all intention actions

You can view the full list of available intention actions, and disable actions that you don't need at the moment. To open the list of intention actions:

  1. Press Ctrl+Alt+S to open the IDE settings and then select Editor | Intentions.

    Settings of intention actions
  2. For each intention action, you can see a description and an example. To disable an intention, clear the checkbox next to it.

  3. Apply the changes and close the dialog.

    Available intention actions

Disable intention actions on the fly

  1. Place the caret at the code element that you want to modify. Then click the light bulb icon (or press Alt+Enter) to open the list of suggestions.

  2. Select the action you want to disable, click the right arrow next to it, and then click Disable <intention action name>.

    Disable intention action

Examples of intention actions

Add a format string argument

  • The Add format string argument intention action generates a placeholder for the expression. The intention action inserts the placeholder into a format string and passes the expression as an argument for the placeholder.

    Add format string argument

Intention actions for declarations

  • You can perform the following actions with Go declarations by using intention actions:

    • Add parentheses to declaration

    • Remove parentheses from declaration

    • Merge declaration up

    • Merge declaration up via comma

    • Merge all declarations

    • Split declarations into two groups

    • Split declaration by comma

    • Split all declarations

    Intention actions for declarations

Fill struct fields

When you create a new struct, you can automatically generate field names for it.

  1. Place a caret between braces of a struct.

  2. Press Alt+Enter.

  3. Select Fill all fields.

  4. Enter field values.

Fill struct fields

Examples of quick fixes

Convert to the expected type

The Convert to the expected type quick-fix Alt+Enter converts a value to the expected type.

Using the Convert to type quick fix

    Finish a call expression

    The Finish call expression quick-fix adds missing brackets and completes the expression.

    Using the Finish call expression quick fix
      Last modified: 19 April 2024