GoLand 2020.1 Help

Running

When you run, debug, or test your code, GoLand creates a temporary run/debug configuration. This configuration includes all the details of how you want to perform the operation. Usually, a temporary configuration is enough to run or debug your code. You can use the temporary configuration to run your application one time, or save it for future use.

Depending on your purposes, you can edit existing or create new configurations. For more information about editing you configurations, seeCreate and edit run/debug configurations.

Create a run/debug configuration

  1. Open the Run/Debug Configuration dialog in one of the following ways:

    • Select Run | Edit Configurations from the main menu.

    • With the Navigation bar visible (View | Appearance | Navigation Bar), choose Edit Configurations from the run/debug configuration selector.

    • Press Alt+Shift+F10, then press 0 or select the configuration from the popup and press F4.

  2. In the Run/Debug Configuration dialog, click the Add New Configuration icon (the Add New Configuration icon) on the toolbar or press Alt+Insert. The list shows the default run/debug configurations. Select the desired configuration type (for example, Go build).

    The fields that appear in the right-hand pane display the default settings for the selected configuration type.

    • Run kind: a scope that includes a file with the main function. You can select between the following scopes:

      • Directory: an application file is in the specified directory.

      • File: the full path to the an application file.

      • Package: the full path to the package with an application file.

    • Output directory: a directory for the executable file.

    • Run after build: execute the application after the build.

    • Working directory: a directory that is used for the built application. If you have any code that creates relative files or directories, they will be relative to this directory.

    • Environment: environment variables for your application.

      To edit environment variables, click the Browse button (the Browse button). In the Environment Variables dialog, click the Add button and add the environment variables that you need.

      Add an environment variable
    • Go tool arguments: arguments for the go tool (for example, -o). Also, you can use macros in this field.

    • Use all custom build tags: all tags that are applied during the build. Tags are listed in settings Ctrl+Alt+S under Go | Build Tags & Vendoring.

    • Program arguments: arguments for the built application. Also, you can use macros in this field.

    • Run with sudo: grant sudo privileges for the application.

    • Before launch: Activate tool window: add tasks that you want to launch before the launch of your application. To add a task click the Add button Alt+Insert and select the tool that you want to add.

    • Module: name of the current module.

    • Before launch: Activate tool window: add tasks that you want to launch before the launch of your application. To add a task click the Add button Alt+Insert and select the tool that you want to add.

    • Store as project file: Enable this option to save your configuration as a project file and share it with team members through VCS.

  3. Apply the changes and close the dialog.

    Create a run/debug configuration

Using the icon in the left gutter

In the left gutter of the editor, click the Run application icon the Run Application icon and select Run <method_name> in <file_name>.

Using the icon in the left gutter

    Using the context menu

    Right-click the opened file or a method in the editor and select Run <method_name> in <file_name> Ctrl+Shift+F10.

    Using the context menu

      Rerun an application

      You can re-run an application if its tab is still opened in the Run window. The program re-runs with the initial settings.

      1. In the Run window, select the tab where the desired application is opened.

      2. In the toolbar, click the Rerun button rerunConsole png, or pressCtrl+F5.

      3. In the notification dialog, click Stop and rerun.

      Rerun an application

      Stop an application

      In the toolbar, click click the Stop button icons.actions.suspend.png on the toolbar, or pressCtrl+F2. Also, the Stop button is available in the Run tool window.

      Stop an application

        View running applications

        You can list all running applications by selecting Run | Show Running List. If no applications are active, the command is greyed out.

        View running applications
          Last modified: 20 July 2020