Go 构建

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

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

项目	描述
运行种类(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` 的 Go \| 构建标记下。
程序实参(P)	为已构建的应用程序输入参数。此外，您可以在此字段中使用宏。
通过sudo 运行(I)	以提升的权限运行应用程序。
模块(M)	当前模块的名称。

常用设置

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

项目	描述
名称(N)	为运行配置指定一个名称，以便在编辑或运行时可快速识别。
允许多个实例(U)	允许并行运行此运行配置的多个实例。默认情况下，该选项处于禁用状态，当您在另一个实例仍在运行时启动此配置，GoLand 会建议停止正在运行的实例并启动另一个实例。当运行配置占用大量资源且没有必要运行多个实例时，此选项非常有用。
存储为项目文件(S)	将包含运行配置设置的文件保存，以便与团队其他成员共享。默认位置为 .idea/runConfigurations 。但是，如果您不想共享 .idea 目录，您可以将配置保存到项目中的任意其他目录。默认情况下，该选项处于禁用状态，GoLand 会将运行配置设置存储在 .idea/workspace.xml 中。

项目

描述

名称(N)

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

允许多个实例(U)

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

默认情况下，该选项处于禁用状态，当您在另一个实例仍在运行时启动此配置，GoLand 会建议停止正在运行的实例并启动另一个实例。当运行配置占用大量资源且没有必要运行多个实例时，此选项非常有用。

存储为项目文件(S)

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

默认情况下，该选项处于禁用状态，GoLand 会将运行配置设置存储在 .idea/workspace.xml 中。

运行/调试配置的树状视图包含一个工具栏，帮助您管理项目中的可用配置，并调整默认配置模板。

项目	快捷键	描述
	`Alt+Insert`	创建运行/调试配置。
	`Alt+Delete`	删除所选的运行/调试配置。请注意，无法删除默认配置。请注意，无法删除默认配置。
	`Ctrl+D`	创建所选运行/调试配置的副本。请注意，您可以复制默认配置。请注意，您可以复制默认配置。
		仅当您选择了临时配置时，才会显示此按钮。单击此按钮可将临时配置保存为永久配置。
		移动到新文件夹 / 创建新文件夹。您可以通过将其放入文件夹中来对运行/调试配置进行分组。要创建文件夹，请选择某一类别中的配置，单击并指定文件夹名称。如果仅聚焦某个类别，则会创建一个空文件夹。然后，若要将配置移动到文件夹中、文件夹之间或移出文件夹，请使用拖放或与按钮。若要取消分组，请选择文件夹并单击。
		单击此按钮按字母顺序对配置进行排序。

启动前

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

项目	快捷键	描述
	`Alt+Insert`	点击此图标以添加以下可用任务之一：启动Web 浏览器：选择此选项以启动浏览器。在打开的对话框中，选择浏览器类型并提供启动 URL。此外，请指定是否希望以 JavaScript 调试器启动浏览器。运行外部工具：选择此项以运行外部应用程序。在打开的对话框中，选择要运行的一个或多个应用程序。如果尚未在 GoLand 中定义，请添加其定义。运行另一个配置：选择此项以执行另一个运行/调试配置，并在启动当前配置前等待其完成。如需并行运行多个配置，请使用复合运行/调试配置。运行File Watcher ：选择此项以使 GoLand 应用所有当前处于活动状态的 File Watcher。运行远程外部工具：添加远程 SSH 外部工具。运行Grunt 任务：选择此项以运行 Grunt 任务。在打开的 Grunt 任务对话框中，指定定义所需任务的 Gruntfile.js ，选择要执行的任务，并指定要传递给 Grunt 工具的参数。 Specify the location of the Node.js interpreter, the parameters to pass to it, and the path to the grunt-cli package. 运行gulp 任务：选择此项以运行 Gulp 任务。在打开的 Gulp 任务对话框中，指定定义所需任务的 Gulpfile.js ，选择要执行的任务，并指定要传递给 Gulp 工具的参数。 Specify the location of the Node.js interpreter, the parameters to pass to it, and the path to the gulp package. 运行npm 脚本：选择此项以执行 npm 脚本。在打开的 NPM 脚本对话框中，指定 npm 运行/调试配置设置。编译TypeScript ：选择此项以运行内建 TypeScript 编译器，从而确保您对 TypeScript 代码所做的所有更改已反映在生成的 JavaScript 文件中。在打开的 TypeScript 编译设置对话框中，选中或取消选中检查错误复选框，以配置在检测到错误时的编译器行为：如果选中检查错误复选框，编译器将显示所有错误，并且运行配置将不会启动。如果取消选中检查错误复选框，编译器将显示所有检测到的错误，但仍会启动运行配置。运行Go 命令：选择此项可在运行程序之前执行 Go 命令。例如，您可以运行 `go generate` 在编译之前生成源代码。在编辑Go 命令任务对话框中，您可以使用自动补全。自动补全支持以下命令 `generate`、 `vet`、 `test -i`。您可以使用自己的命令。断开数据源：如果您希望在运行/调试配置执行之前中断与数据源的连接，请选择此选项。
	`Alt+Delete`	单击此图标可从列表中移除所选任务。
	`Enter`	单击此图标可编辑所选任务。在打开的对话框中进行必要的更改。
	`Alt+Up` `Alt+Down`	单击这些图标可将所选任务在列表中上移或下移一行。任务将按照其在列表中的顺序依次执行。
显示此页面		选中此复选框可在实际开始运行/调试配置之前显示运行/调试配置设置。
激活工具窗口		默认情况下，将选中此复选框，并在启动运行/调试配置时打开 Run 或 Debug 工具窗口。否则，如果未选中该复选框，工具窗口将被隐藏。但是，在配置运行期间，您可以按 `Alt+4` 或 `Alt+5` 手动打开相应的工具窗口。

最后修改日期： 2025年 9月 26日