Go Build

创建：运行 | 编辑配置 | | Go Build

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

项目	描述
运行类型	为您的应用程序选择一个构建范围。文件和软件包作用域在测试和编译/运行配置中（就其覆盖的范围而言）工作类似。目录：在指定目录中构建一个应用程序作为包，不处理任何子目录。软件包运行类型是默认值。文件：从个文件字段中指定的文件构建应用程序。要传递多个文件路径，请使用竖线(`\|`) 作为分隔符。此配置将在您从草稿文件运行程序时自动选择。软件包：构建包含所有依赖项的单个包。在包路径字段中指定要构建的包的完整导入路径（例如， `github.com/gorilla/mux`）。当使用装订区域中的运行应用程序图标（）运行 `main` 函数时，会自动选择此配置。
包路径	键入或自动补全您要编译的包的完整导入路径（例如， `github.com/gorilla/mux`）。仅当您选择软件包运行类型时，此字段才可用。您可以按 `Ctrl+Space` 查看可用软件包列表。
目录	键入您要编译的 Go 应用程序目录的路径（例如， `/Users/jetbrains/go/src/serverApp`）。仅当您选择目录运行类型时，此字段才可用。
个文件	键入您要编译的 Go 应用程序文件或文件的路径（例如， `/Users/jetbrains/go/src/serverApp/main.go`）。要传递多个文件路径，请使用竖线(`\|`) 作为分隔符。仅当您选择文件运行类型时，此字段才可用。
输出目录	键入您希望输出可执行文件的目录路径。
在远程目标上构建	选择非本地运行目标时，将显示此复选框。默认情况下未选中。选择此项可将源文件复制到目标并在那里构建。选择此项时，GoLand 会隐藏输出目录字段。清除此项可在本地构建并将可执行文件复制到目标。如果所选 Go SDK 位于 WSL 中，即使清除此复选框，GoLand 也会在运行目标上构建。有关更多信息，请参阅在目标上运行。
构建后运行	在构建后执行应用程序。
在输出控制台中模拟终端	执行应用程序并在运行工具窗口中显示输出，就像在终端中显示一样。
从以下位置重定向输入	指定要从中读取输入的文件。
工作目录	键入用于构建应用程序的目录。如果您有任何创建相对文件或目录的代码，它们将相对于该目录。
环境	为您的应用程序指定环境变量。要编辑环境变量，请点击字段末尾的浏览按钮。在环境变量对话框中，点击添加按钮并添加您需要的环境变量。
Go tool 参数	键入 go 工具的参数（例如， `-o`）。另外，您可以在此字段中使用宏。
使用所有 custom build tags	选中此复选框可将前往 \| 构建标记下自定义标签字段中的标记添加到构建命令。如果 Go tool 参数已包含 `-tags` ，命令将改用这些标记。
程序参数	键入构建应用程序的参数。另外，您可以在此字段中使用宏。
需要使用sudo运行	以提升的权限运行应用程序。
模块	当前模块名称。

通用设置

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

项目	描述
名称	为运行配置指定一个名称，以便在编辑或运行时能快速识别。
允许多个实例	允许并行运行多个此运行配置实例。默认情况下，它是禁用的，当您在另一个实例仍在运行时启动此配置时，GoLand建议停止正在运行的实例并启动另一个实例。这在运行配置消耗大量资源且没有充足理由运行多个实例时很有帮助。
存储为项目文件	将运行配置设置保存到文件中，以便与其他团队成员共享。默认位置是 .idea/runConfigurations 。但是，如果您不想共享 .idea 目录，您可以将配置保存到项目中的任何其他目录。默认情况下，它是禁用的，并且 GoLand 将运行配置设置存储在 .idea/workspace.xml 。

项目

描述

名称

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

允许多个实例

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

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

存储为项目文件

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

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

启动前

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

项目	快捷方式	描述
	`Alt+Insert`	点击此图标以添加以下可用任务之一：启动 Web 浏览器：选择此选项即可启动浏览器。在打开的对话框中，选择浏览器的类型并提供起始 URL。此外，指定是否希望浏览器以启用 JavaScript 调试器的方式启动。运行外部工具：选择运行外部应用程序。在打开的对话框中，选择一个或多个您想要运行的应用程序。如果它在 GoLand 中尚未定义，请添加其定义。运行另一个配置：选择执行另一个运行/调试配置，并等待其完成后再开始当前配置。如果您想并行运行多个配置，请使用 compound run/debug configuration。运行 File Watchers ：选择此选项以让 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`	点击此图标可编辑选定的任务。请在打开的对话框中进行必要的更改。
	`Alt+Up` `Alt+Down`	点击这些图标以在列表中将所选任务上移或下移一行。任务将按照它们在列表中出现的顺序执行。
显示此页面		选中此复选框以在实际启动运行/调试配置之前显示运行/调试配置设置。
激活工具窗口		默认情况下，此复选框处于选中状态，并且在您启动 run/debug 配置时， Run 或 Debug 工具窗口会打开。否则，如果复选框未选中，工具窗口将被隐藏。但是，在配置运行时，您可以通过按 `Alt+4` 或 `Alt+5` 自行打开相应的工具窗口。
使工具窗口获得焦点		选择此复选框可在启动运行/调试配置时，自动将焦点切换到运行或调试工具窗口。

日志

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

项目	描述
指定要在控制台中显示的日志	指定在运行应用程序时显示哪些日志文件。点击添加新日志。在编辑日志文件别名对话框中，配置以下内容：别名：日志将显示的选项卡名称。日志文件位置：指定日志文件的路径或 Ant 模式。如果多个滚动日志文件匹配该模式，GoLand 将显示最新的一个。显示所有可由模式匹配的文件：显示所有匹配该模式的日志。对于表格中的日志，您可以配置以下选项：是否激活：显示指定的日志文件。跳过内容：不显示先前运行的旧日志消息。
将控制台输出保存到文件	将控制台输出保存到指定位置。手动输入路径，或点击浏览按钮，然后在打开的对话框中指向所需位置。
在消息打印到 stdout 时显示控制台	当应用程序写入标准输出流时激活控制台。
在消息打印到 stderr 时显示控制台	当应用程序写入标准错误流时激活控制台。

2026年 11月 9日