GoLand 2026.3 Help

运行测试

创建： 运行 | 编辑配置 | 添加新配置| 运行测试

使用 运行测试 配置，可以运行和调试 Go 测试。 有关运行测试的更多信息，请参考以下主题：

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 并选择您想要添加的工具。

通用设置

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

项目

描述

名称

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

允许多个实例

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

默认情况下，它是禁用的，当您在另一个实例仍在运行时启动此配置时，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

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

方法向上

方法 down

Alt+Up

Alt+Down

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

显示此页面

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

激活工具窗口

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

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

使工具窗口获得焦点

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

日志

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

项目

描述

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

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

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

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

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

  • 显示所有可由模式匹配的文件 ：显示所有匹配该模式的日志。

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

  • 是否激活 ：显示指定的日志文件。

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

将控制台输出保存到文件

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

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

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

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

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

2026年 11月 9日
远程编程运行/调试配置：JavaScript 调试