GoLand 2026.1 Help

Go Build

创建： 运行(U)｜ 编辑配置(E)｜ 添加新配置| Go Build

使用 Go Build 配置，您可以运行、编译和调试 Go 应用程序。 有关从模板创建运行/调试配置的更多信息，请参阅 从模板创建运行/调试配置。

Go Build 的运行/调试配置

项目

描述

运行种类(K)

为您的应用程序选择一个构建范围。 文件 和 软件包 作用域在测试和编译/运行配置中（就其覆盖的范围而言）工作类似。

  • 目录 ：在指定目录中构建一个应用程序作为包，不处理任何子目录。 软件包 运行类型是默认值。

  • 文件 ：从 文件(F) 字段中指定的文件构建应用程序。 要传递多个文件路径，请使用竖线(|) 作为分隔符。 此配置将在您从草稿文件运行程序时自动选择。

  • 软件包 ：构建包含所有依赖项的单个包。 在 软件包路径(E) 字段中指定要构建的包的完整导入路径（例如， github.com/gorilla/mux）。 该配置会在您运行 main 函数或通过在装订线中使用 运行应用程序 图标（运行应用程序按钮 ）单独测试时自动选择。

软件包路径(E)

键入或自动补全您要编译的包的完整导入路径（例如， github.com/gorilla/mux）。 仅当您选择 软件包 运行类型时，此字段才可用。

您可以按 Ctrl+Space 查看可用软件包列表。

包路径字段的自动补全

目录(D)

键入您要编译的 Go 应用程序目录的路径（例如， /Users/jetbrains/go/src/serverApp）。 仅当您选择 目录 运行类型时，此字段才可用。

文件(F)

键入您要编译的 Go 应用程序文件或文件的路径（例如， /Users/jetbrains/go/src/serverApp/main.go）。 要传递多个文件路径，请使用竖线(|) 作为分隔符。 仅当您选择 文件 运行类型时，此字段才可用。

输出目录(O)

键入您希望输出可执行文件的目录路径。

构建后运行(R)

在构建后执行应用程序。

在输出控制台中模拟终端

执行应用程序并在 运行 工具窗口中显示输出，就像在终端中显示一样。

在输出控制台中模拟终端

重定向输入自

指定要从中读取输入的文件。

工作目录(W)

键入用于构建应用程序的目录。 如果您有任何创建相对文件或目录的代码，它们将相对于该目录。

环境(V)

为您的应用程序指定环境变量。

要编辑环境变量，请点击字段末尾的 浏览 按钮。 在 环境变量 对话框中，点击 添加 按钮并添加您需要的环境变量。

添加环境变量

Go 工具实参(G)

键入 go 工具的参数（例如， -o）。 另外，您可以在此字段中使用宏。

使用所有自定义构建标记(L)

指定在构建期间应用的所有标签。 标签列在设置 Ctrl+Alt+S 的 前往 | 构建标记 下。

程序实参(P)

键入构建应用程序的参数。 另外，您可以在此字段中使用宏。

通过sudo 运行(I)

以提升的权限运行应用程序。

模块(M)

当前模块名称。

通用设置

当您编辑运行配置（而不是运行配置模板）时，您可以指定以下选项：

项目

描述

名称(N)

为运行配置指定一个名称，以便在编辑或运行时能快速识别。

允许多个实例(U)

允许并行运行多个此运行配置实例。

默认情况下，它是禁用的，当您在另一个实例仍在运行时启动此配置时，GoLand建议停止正在运行的实例并启动另一个实例。 这在运行配置消耗大量资源且没有充足理由运行多个实例时很有帮助。

存储为项目文件(S)

将运行配置设置保存到文件中，以便与其他团队成员共享。 默认位置是 .idea/runConfigurations 。 但是，如果您不想共享 .idea 目录，您可以将配置保存到项目中的任何其他目录。

默认情况下，它是禁用的，并且 GoLand 将运行配置设置存储在 .idea/workspace.xml 。

启动前

在此区域，您可以指定在启动所选运行/调试配置之前要执行的任务。 任务按它们在列表中出现的顺序执行。

项目

快捷方式

描述

添加按钮

Alt+Insert

点击此图标以添加以下可用任务之一：

  • 启动Web 浏览器 ：选择此选项即可启动浏览器。 在打开的对话框中，选择浏览器的类型并提供起始 URL。 此外，指定是否希望浏览器以启用 JavaScript 调试器的方式启动。

  • 运行外部工具 ：选择运行外部应用程序。 在打开的对话框中，选择一个或多个您想要运行的应用程序。 如果它在 GoLand 中尚未定义，请添加其定义。

  • 运行另一个配置 ：选择执行另一个运行/调试配置，并等待其完成后再开始当前配置。 如果您想并行运行多个配置，请使用 compound run/debug configuration。

  • 运行File Watcher ：选择此选项以让 GoLand 应用所有当前活动的 文件监视器。

  • 运行远程外部工具 ：添加一个远程 SSH 外部工具。

  • 运行Grunt 任务 ：选择此选项来运行 Grunt 任务。

    在打开的 Grunt task 对话框中，指定定义所需任务的 Gruntfile.js ，选择要执行的任务，并指定要传递给 Grunt 工具的参数。

    指定 Node.js 解释器的位置、传递给它的参数以及 grunt-cli 包的路径。

  • 运行gulp 任务 ：选择此选项以运行 Gulp 任务。

    在打开的 Gulp 任务 对话框中，指定定义所需任务的 Gulpfile.js ，选择要执行的任务，并指定要传递给 Gulp 工具的参数。

    指定 Node.js 运行时的位置、要传递给它的参数，以及 gulp 包的路径。

  • 运行npm 脚本 ：选择此选项来执行 npm 脚本。

    在 NPM Script 对话框中，指定 npm run/debug configuration settings。

  • 编译TypeScript ：选择运行内置的 TypeScript 编译器，从而确保您对 TypeScript 代码所做的所有更改都反映在生成的 JavaScript 文件中。 在打开的 TypeScript 编译设置 对话框中，选择或清除此 检查错误 复选框，以配置编译器在检测到错误时的行为:

    • 如果选中了 检查错误 复选框，编译器会显示所有错误，并且运行配置将不会启动。

    • 如果清除了 检查错误 复选框，编译器将显示所有检测到的错误，但运行配置仍将启动。

  • 运行Go 命令 ：选择此选项以在运行程序之前运行 Go 命令。 例如，您可以运行 go generate 以在编译之前生成源代码。 在 编辑Go 命令任务 对话框中，您可以使用自动补全。 自动补全支持以下命令 generate、 vet、 test -i。 您可以使用自己的命令。

  • 断开数据源 ：如果您希望在运行/调试配置运行之前中断与数据源的连接，请选择此选项。

"移除"按钮

Alt+Delete

点击此图标可将所选任务从列表中移除。

编辑

Enter

点击此图标可编辑选定的任务。 请在打开的对话框中进行必要的更改。

方法向上

方法 down

Alt+Up

Alt+Down

点击这些图标以在列表中将所选任务上移或下移一行。 任务将按照它们在列表中出现的顺序执行。

显示此页面

选中此复选框以在实际启动运行/调试配置之前显示运行/调试配置设置。

激活工具窗口

默认情况下，此复选框处于选中状态，并且在您启动 run/debug 配置时， Run 或 Debug 工具窗口会打开。

否则，如果复选框未选中，工具窗口将被隐藏。 但是，在配置运行时，您可以通过按 Alt+4 或 Alt+5 自行打开相应的工具窗口。

使工具窗口获得焦点

选择此复选框可在启动运行/调试配置时，自动将焦点切换到 运行或 调试工具窗口。

日志

以下选项与记录此配置的执行相关。 欲了解更多信息，请参阅 设置日志选项。

项目

描述

指定要在控制台中显示的日志

指定在运行应用程序时显示哪些日志文件。

点击 添加按钮 添加新日志。 在 编辑日志文件别名 对话框中，配置以下内容：

  • 别名(A) ：日志将显示的选项卡名称。

  • 日志文件位置(L) ：指定日志文件的路径或 Ant 模式。 如果多个滚动日志文件匹配该模式，GoLand 将显示最新的一个。

  • 显示可由模式覆盖的所有文件(S) ：显示所有匹配该模式的日志。

对于表格中的日志，您可以配置以下选项：

  • 处于活动状态 ：显示指定的日志文件。

  • 跳过内容 ：不显示先前运行的旧日志消息。

将控制台输出保存到文件(S)

将控制台输出保存到指定位置。 手动输入路径，或点击浏览按钮，然后在 打开的对话框 中指向所需位置。

在消息打印到stdout 时显示控制台

当应用程序写入标准输出流时激活控制台。

在消息打印到stderr 时显示控制台

当应用程序写入标准错误流时激活控制台。

2026年 3月 26日
运行/调试配置：Gulp.js远程编程