运行测试
创建： 
使用 运行测试 配置，您可以运行和调试 Go 应用程序。 有关运行测试的更多信息，请参考以下主题：
Go 测试配置中的字段列表
名称 | 描述 |
|---|
测试框架(R) | 选择您希望用于运行测试的包。 gotest ：用于运行标准单元测试。 如需了解更多有关 go test 的信息，请参阅 软件包测试。 gocheck ：用于扩展 go check 的功能并运行更复杂的测试。 如需了解更多有关 go check 的信息，请参考 go check。 gobench ：用于运行性能测试。 如需了解更多有关 gobench 的信息，请参阅 包测试：基准测试。 go test -fuzz ：使用一种自动化测试技术，该技术涉及生成并将大量随机或半随机数据作为输入提供给 Go 程序。 模糊测试的目标是探索程序代码并发现潜在的错误、漏洞或传统测试方法可能无法显现的意外行为。 如需了解更多有关 gobench 的信息，请参考 Go Fuzzing。
 |
测试种类(K) | 选择您希望运行测试的范围： 目录 ：运行指定目录中的所有测试。 在 目录(D) 字段中，指定包含应用程序文件和测试文件的目录路径（例如， applicationFolder/ ，包含 main.go 和 main_test.go ）。 软件包 ：运行属于某个包的所有测试。 在 软件包路径(E) 字段中，选择包含您希望运行的测试的包路径（例如， github.com/rcrowley/go-metrics）。 要启用包测试，请按 Ctrl+Alt+S 打开设置，导航到 ，并选中 启用Go 模块集成 复选框。 文件 ：运行测试文件中的所有测试。 在 文件(F) 字段中，输入测试文件的路径。 确保 文件(F) 字段不包含其他路径。
|
模式(P) | 输入定义要运行哪些测试的正则表达式。 GoLand 将仅执行符合所提供正则表达式的测试、示例和模糊测试。 对于测试，表达式由斜杠（/ ）分隔，而不是括号内的内容，形成一系列正则表达式。 测试标识符的每个部分必须与序列中相应部分对齐。 例如，要执行名为 add_positive_and_negative 的特定测试，该测试位于 TestAdd 表测试中，正则表达式将是： ^\QTestAdd\E$/^\Qadd_positive_and_negative\E$。  |
工作目录(W) | 用于构建应用程序的目录。 如果您有任何创建相对文件或目录的代码，它们将相对于该目录。 |
输出目录(O) | 存储测试结果的目录（如果有）。 |
构建后运行(R) | 在构建后执行测试。 |
重定向输入自 | 将用于接收程序输入的文件路径，而不是控制台。 |
工作目录(W) | 用于构建应用程序的目录。 如果您有任何创建相对文件或目录的代码，它们将相对于该目录。 |
环境(V) | ：运行测试所需的环境变量。 要编辑环境变量，请点击字段末尾的 浏览 按钮。 在 环境变量 对话框中，点击 添加 按钮并添加您需要的环境变量。  |
Go 工具实参(G) | 用于 go 工具的参数（例如， -tags）。 |
使用所有自定义构建标记(L) | 在构建期间应用的所有标签。 标签列在设置 Ctrl+Alt+S 的 下。 |
程序实参(P) | 测试的参数。 |
通过sudo 运行(I) | 为测试授予 sudo 权限。 |
启动前：激活工具窗口 | 添加任务，您可以在选择的运行/调试配置启动之前启动这些任务。 要添加任务，请点击 添加 按钮 Alt+Insert 并选择您想要添加的工具。 |
通用设置
当您编辑运行配置（而不是运行配置模板）时，您可以指定以下选项：
项目 | 描述 |
|---|
名称(N) | 为运行配置指定一个名称，以便在编辑或运行时能快速识别。 |
允许多个实例(U) | 允许并行运行多个此运行配置实例。 默认情况下，它是禁用的，当您在另一个实例仍在运行时启动此配置时，GoLand建议停止正在运行的实例并启动另一个实例。 这在运行配置消耗大量资源且没有充足理由运行多个实例时很有帮助。 |
存储为项目文件(S) | 将运行配置设置保存到文件中，以便与其他团队成员共享。 默认位置是 .idea/runConfigurations 。 但是，如果您不想共享 .idea 目录，您可以将配置保存到项目中的任何其他目录。 默认情况下，它是禁用的，并且 GoLand 将运行配置设置存储在 .idea/workspace.xml 。 |
启动前
在此区域，您可以指定在启动所选运行/调试配置之前要执行的任务。 任务按它们在列表中出现的顺序执行。
项目 | 快捷方式 | 描述 |
|---|
| Alt+Insert | 点击此图标以添加以下可用任务之一： 启动Web 浏览器 ：选择此选项即可启动浏览器。 在打开的对话框中，选择浏览器的类型并提供起始 URL。 此外，指定是否希望浏览器以启用 JavaScript 调试器的方式启动。 运行外部工具 ：选择运行外部应用程序。 在打开的对话框中，选择一个或多个您想要运行的应用程序。 如果它在 GoLand 中尚未定义，请添加其定义。 运行另一个配置 ：选择执行另一个运行/调试配置，并等待其完成后再开始当前配置。 如果您想并行运行多个配置，请使用 compound run/debug configuration。 运行File Watcher ：选择此选项以让 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 自行打开相应的工具窗口。 |
使工具窗口获得焦点 | | 选择此复选框可在启动运行/调试配置时，自动将焦点切换到 运行或 调试工具窗口。 |
日志
以下选项与记录此配置的执行相关。 欲了解更多信息，请参阅 设置日志选项。
项目 | 描述 |
|---|
指定要在控制台中显示的日志 | 指定在运行应用程序时显示哪些日志文件。 点击 添加新日志。 在 编辑日志文件别名 对话框中，配置以下内容： 对于表格中的日志，您可以配置以下选项： 处于活动状态 ：显示指定的日志文件。 跳过内容 ：不显示先前运行的旧日志消息。
|
将控制台输出保存到文件(S) | 将控制台输出保存到指定位置。 手动输入路径，或点击浏览按钮，然后在 打开的对话框 中指向所需位置。 |
在消息打印到stdout 时显示控制台 | 当应用程序写入标准输出流时激活控制台。 |
在消息打印到stderr 时显示控制台 | 当应用程序写入标准错误流时激活控制台。 |
2026年 3月 26日