GoLand 2026.3 Help

运行/调试配置

GoLand 使用运行/调试配置来运行、调试和测试您的代码。 每个配置是一组命名的启动属性,用于定义要执行的内容以及应使用的参数和环境。

有两种 运行/调试 配置:

  • 临时 — 在运行或调试 main 函数或测试且不存在匹配的永久配置时创建。

  • 永久—由模板显式创建或通过保存临时配置创建。 永久配置将作为您项目的一部分,直到您删除它们。

每当您运行、调试或测试代码时,GoLand 要么使用现有的永久运行/调试配置,要么创建一个新的临时配置。

永久配置的图标是不透明的,而临时配置的图标是半透明的。 配置图标上的红色叉号表示配置设置中存在错误。

临时配置的最大数量为 5。 添加新版本时,旧版本会被自动删除。 如有必要,您可以在 设置 | 高级设置 | 运行/调试 | 临时配置限制 中增加此限制。

创建临时运行/调试配置

要创建临时运行/调试配置,您可以从边栏或上下文菜单运行代码。

从编辑器运行

如果您不打算向程序传递任何参数,并且程序不需要在启动前执行任何特定操作,则可以直接从编辑器运行它。

  • 点击 ,位于 边距 中靠近 main 函数的位置,然后选择 运行。

  • 要运行脚本,请在编辑器中打开它或在 项目 工具窗口中选择它,然后从上下文菜单中选择 运行 <script file name>。

创建永久运行/调试配置

GoLand 提供以下方法来创建永久运行/调试配置:

将临时配置保存为永久配置

  • 在 运行/调试 配置切换器中选择一个临时配置,点击 / 并选择 保存配置。

  • 或者,在“运行/调试配置”对话框中选择一个临时配置,然后点击工具栏上的 保存。

GoLand 为不同的语言、工具和框架提供运行/调试配置 模板。 可用模板的列表会因已安装和启用的 plugins 而有所不同。

从模板创建运行/调试配置

  1. 转到 运行 | 编辑配置。 或者,按 Alt+Shift+F10 ,然后 0。

  2. 在 运行/调试配置 对话框中,点击工具栏上的 或按 Alt+Insert。 该列表显示运行/调试配置模板。 选择 Go Build.

  3. 在 名称 字段中指定运行/调试配置名称。 此名称将用于在列表和菜单中标识运行/调试配置。

  4. 在 配置 选项卡上,您可以设置以下选项:

  5. 在 启动前 部分中,定义是否要在启动应用程序之前执行任何特定操作,例如在运行前启动 外部工具或另一个运行/调试配置。

  6. 您可以立即运行该配置,也可以保存配置以便稍后运行。

    • 要保存运行配置以供稍后运行,请点击 确定。

    • 若要立即运行此配置,请点击 运行。

Go Build 配置中的字段列表

名称

描述

运行类型

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

  • 目录 :在指定目录中将应用程序构建为包,而不处理任何子目录。

    对于测试配置,GoLand 会运行指定目录及其所有子目录中的所有测试。

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

  • 软件包 :构建包含其所有依赖项的单个包。 在 包路径 字段中指定要构建的包的完整导入路径(例如, github.com/gorilla/mux)。 当使用装订区域中的 运行应用程序 图标(“运行”按钮 )运行 main 函数时,会自动选择此配置。

包路径

要编译的包的完整导入路径(例如, myServerApp)。 仅当您选择 软件包 运行类型时,此字段才可用。

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

输出目录

要输出可执行文件的目录路径。

在远程目标上构建

选择非本地运行目标时,将显示此复选框。 默认情况下未选中。

选择此项可将源文件复制到目标并在那里构建。 选择此项时,GoLand 会隐藏 输出目录 字段。

清除此项可在本地构建并将可执行文件复制到目标。

如果所选 Go SDK 位于 WSL 中,即使清除此复选框,GoLand 也会在运行目标上构建。 有关更多信息,请参阅 在目标上运行。

构建后运行

在构建后执行应用程序。

在输出控制台中模拟终端

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

从以下位置重定向输入

要从中读取输入的文件。

工作目录

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

环境

应用程序的环境变量。

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

Go tool 参数

用于 go 工具的参数(例如, -o)。 此外,您可以在此字段中使用 宏。

使用所有 custom build tags

选中此复选框可将 前往 | 构建标记 下 自定义标签 字段中的标记添加到构建命令。

如果 Go tool 参数 已包含 -tags ,命令将改用这些标记。

程序参数

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

需要使用sudo运行

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

模块

当前模块名称。

启动前

添加任务,您可以在选择的运行/调试配置启动之前启动这些任务。 要添加任务,请点击 添加 按钮 Alt+Insert 并选择您想要添加的工具。

存储为项目文件

启用此选项以将您的配置保存为项目文件,并通过 VCS 与团队成员共享。

Go 测试配置中的字段列表

名称

描述

测试框架

选择要使用的测试框架。

  • gotest :运行标准 Go 测试。 如需了解更多有关 go test 的信息,请参阅 软件包测试。

  • gocheck :使用 gocheck 框架运行测试。

  • gobench :运行基准测试。 有关更多信息,请参阅 软件包测试:基准测试 。夫},{

  • go test -fuzz :运行模糊测试。 模糊测试会向代码发送随机或意外输入以发现问题。 有关更多信息,请参阅 Go 模糊测试。

    使用 运行 开始模糊测试。 调试 操作不适用于 go test -fuzz 框架。

测试类型

选择您希望运行测试的范围:

  • 目录 :在所选目录及其子目录中运行测试。 在 目录 字段中指定目录。

    要调试测试,请改为选择 软件包。

  • 软件包 :在软件包中运行测试。 在 包路径 字段中,输入软件包导入路径,例如 example.com/myapp/calc。

  • 文件 :从所选文件运行测试。 在 个文件 字段中,输入用 | 分隔的文件路径,例如 /work/myapp/calc.go|/work/myapp/calc_test.go。 从同一目录中选择文件。 至少有一个文件需要支持所选测试框架。

模式

此字段适用于 目录 和 软件包 作用域。 对于 文件 作用域,未设置模式时,GoLand 会根据所选文件中的测试函数生成模式。

输入正则表达式以选择要运行的测试。 对于包含子测试的测试,请使用 / 分隔表达式。 第一个表达式匹配测试名称,后续每个表达式匹配下一级的子测试名称。

例如,要运行 TestAdd 的 add_positive_and_negative 子测试,请输入 ^\QTestAdd\E$/^\Qadd_positive_and_negative\E$。

工作目录

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

输出目录

使用 文件 或 软件包 作用域时,已编译测试可执行文件的目录。

在远程目标上构建

选择非本地运行目标时,将显示此复选框。 默认情况下未选中。

选择此项可将源文件复制到目标并在那里构建。 选择此项时,GoLand 会隐藏 输出目录 字段。

清除此项可在本地构建并将可执行文件复制到目标。

如果所选 Go SDK 位于 WSL 中,即使清除此复选框,GoLand 也会在运行目标上构建。 有关更多信息,请参阅 在目标上运行。

从以下位置重定向输入

要用作标准输入而不是控制台的文件路径。

环境

:运行测试所需的环境变量。

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

Go tool 参数

用于 go 工具的参数(例如, -tags)。

使用所有 custom build tags

选中此复选框可将 前往 | 构建标记 下 自定义标签 字段中的标记添加到构建命令。

如果 Go tool 参数 已包含 -tags ,命令将改用这些标记。

如果 Go tool 参数 和此复选框均未提供 -tags ,GoLand 可以从测试文件中的 //go:build 和 // +build 约束中选择标记。 这适用于 文件 作用域,也适用于 GoLand 可以识别所选测试函数时的 软件包 作用域。

程序参数

测试的参数。

需要使用sudo运行

以提升的权限运行测试。 当操作系统支持进程提升时,此选项可用于本地配置。

启动前:激活工具窗口

添加任务,您可以在选择的运行/调试配置启动之前启动这些任务。 要添加任务,请点击 添加 按钮 Alt+Insert 并选择您想要添加的工具。

启动前

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

项目

快捷方式

描述

添加按钮

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

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

方法向上

方法 down

Alt+Up

Alt+Down

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

显示此页面

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

激活工具窗口

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

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

使工具窗口获得焦点

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

启动运行配置

您可以通过以下方式之一启动现有的运行配置:

  • 如果运行配置已在 运行小组件 中选中,请单击其旁边的 或按 Shift+F10。

  • 如果您想选择其他运行配置,请单击 运行小组件。 在打开的菜单中,单击您想启动的运行配置旁的 。

  • 按下 Alt+Shift+F10。 在打开的菜单中,单击您想启动的运行配置。

共享运行/调试配置

您可能希望共享您的 运行/调试 配置,以便您的团队成员可以使用相同的配置运行应用程序,或者使他们能够远程附加到您正在运行的进程。

GoLand 提供了一种机制,可以将您的 运行/调试 配置存储为项目文件并通过 VCS 共享。 当您希望将配置作为文件发送给其他人、创建运行/调试配置的本地备份或从文件导入它们时,也可以使用相同的机制。

  1. 转到 运行 | 编辑配置。 或者,按 Alt+Shift+F10 ,然后 0。

  2. 请选择您要共享的 运行/调试 配置,启用 存储为项目文件 选项,并指定配置文件的存储位置。

    您可以配置任何位置,除非需要与 GoLand 2019.3 及更早版本兼容。 为了与这些版本兼容,请将文件存储在建议的位置。

  3. (可选)如果将 .idea 目录添加到 VCS 忽略文件中,那么 .idea/runConfigurations 子文件夹也将被忽略。 如果项目使用 Git,您可以共享 .idea/runConfigurations 并保留 .idea 被忽略,通过修改 .gitignore 如下:

    /.idea/* !/.idea/runConfigurations

运行/调试配置模板

所有运行/调试配置都基于模板,这些模板实现了启动逻辑,定义参数列表及其默认值。 安装中预定义了 可用模板列表 ,只能通过 插件进行扩展。 但是,您可以编辑每个模板中的默认参数值,以便于新运行/调试配置的设置。

配置模板的默认值

  1. 转到 运行 | 编辑配置。 或者,按 Alt+Shift+F10 ,然后 0。

  2. 在 运行/调试 配置对话框的左侧窗格中,点击 编辑配置模板…。

  3. 在打开的 运行/调试配置模板 对话框中,选择一个配置类型。

  4. 请指定所需的默认参数,然后点击 确定 以保存模板。

运行/调试配置文件夹

当有许多相同类型的 运行/调试 配置时,您可以将它们分组到文件夹中以便于访问。

为运行/调试配置创建一个文件夹

  1. 转到 运行 | 编辑配置。 或者,按 Alt+Shift+F10 ,然后 0。

  2. 在 运行/调试配置 对话框中,选择配置类型并在工具栏上点击 新建文件夹图标。 已创建一个新的空文件夹用于所选类型。

  3. 请在右侧的文本框中指定文件夹名称或接受默认名称。

  4. 选择所需的 运行/调试 配置并将它们移动到目标文件夹下。

  5. 应用这些更改。 如果一个文件夹是空的,它将不会被保存。

当您不再需要文件夹时,可以将其删除 Delete。 此文件夹下的 运行/调试 配置将被移动到相应 运行/调试 配置类型的根目录下。

2026年 11月 9日