Go Build

创建：运行(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 应用所有当前活动的文件监视器。运行远程外部工具：添加一个远程 SSH 外部工具。运行Grunt 任务：选择此选项来运行 Grunt 任务。在打开的 Grunt 任务对话框中，指定定义所需任务的 Gruntfile.js ，选择要执行的任务，并指定要传递给 Grunt 工具的参数。指定 Node.js 解释器的位置、传递给它的参数以及 grunt-cli 包的路径。运行gulp 任务：选择此选项以运行 Gulp task。在打开的 Gulp 任务对话框中，指定定义所需任务的 Gulpfile.js ，选择要执行的任务，并指定传递给 Gulp 工具的参数。指定 Node.js 运行时的位置、要传递给它的参数，以及 gulp 包的路径。运行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 配置时， Run 或 Debug 工具窗口会打开。否则，如果清除此复选框，将隐藏该工具窗口。但是，当配置正在运行时，您可以通过按 `Alt+4` 或 `Alt+5` 自行打开相应的工具窗口。

最后修改日期： 2025年 12月 5日