GoLand 2025.3 Help

运行/调试配置

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

有两种 运行/调试 配置：

  • 临时 — 每次运行或调试函数或测试时创建。

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

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

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

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

永久配置和临时配置有不同的图标

创建临时运行/调试配置

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

从编辑器运行

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

  • 点击 ，位于 边栏 的 main 函数附近，然后选择 运行。

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

创建永久运行/调试配置

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

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

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

    保存临时运行配置

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

    保存临时配置

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

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

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

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

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

  4. 在 配置 选项卡上，您可以设置以下选项：

  5. 在 启动前 部分中，定义是否要在启动应用程序之前执行任何特定操作，例如启动一个 外部工具 或另一个构建配置。 要跳过构建阶段，请从 启动前 列表中移除 构建。

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

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

    • 要立即运行该配置，请点击 运行。

Go Build 配置中的字段列表

名称

描述

运行种类(K)

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

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

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

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

  • 软件包 ：构建包含其所有依赖项的单个包。 在 软件包路径(E) 字段中指定要构建的包的完整导入路径（例如， github.com/gorilla/mux）。 该配置会在您运行 main 函数或通过在装订线中使用 运行应用程序 图标（“运行”按钮 ）单独测试时自动选择。

软件包路径(E)

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

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

包路径字段的自动补全

输出目录(O)

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

构建后运行(R)

在构建后执行应用程序。

在输出控制台中模拟终端

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

在输出控制台中模拟终端

重定向输入自

要从中读取输入的文件。

工作目录(W)

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

环境(V)

应用程序的环境变量。

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

添加环境变量

Go 工具实参(G)

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

使用所有自定义构建标记(L)

在构建期间应用的所有标签。 标签列在设置 Ctrl+Alt+S 的 Go 构建标记 下。

程序实参(P)

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

通过sudo 运行(I)

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

模块(M)

当前模块名称。

执行前(B)

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

存储为项目文件(S)

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

Go Test 配置中的字段列表

名称

描述

测试框架(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 Go 模块 ，并选择 启用Go 模块集成 复选框。

  • 文件 ：运行测试文件中的所有测试。 在 文件(F) 字段中，输入测试文件的路径。

    确保 文件(F) 字段不包含其他路径。

模式(P)

输入定义要运行哪些测试的正则表达式。 GoLand 将仅执行符合所提供正则表达式的测试、示例和模糊测试。 对于测试，表达式由不包含在括号中的斜杠（/ ）分隔为一系列正则表达式。 测试标识符的每个部分必须与序列中相应部分对齐。

例如，要在 TestAdd 表测试中执行名为 add_positive_and_negative 的特定测试，正则表达式将是： ^\QTestAdd\E$/^\Qadd_positive_and_negative\E$。

label.scope.pattern

工作目录(W)

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

输出目录(O)

存储测试结果的目录（如果有）。

构建后运行(R)

在构建后执行测试。

重定向输入自

将程序输入替代控制台的文件路径。

工作目录(W)

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

环境(V)

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

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

添加环境变量

Go 工具实参(G)

用于 go 工具的参数（例如， -tags）。

使用所有自定义构建标记(L)

在构建期间应用的所有标签。 标签列在设置 Ctrl+Alt+S 的 Go 构建标记 下。

程序实参(P)

测试的参数。

通过sudo 运行(I)

授予测试 sudo 权限。

启动前：激活工具窗口

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

启动前

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

项目

快捷键

描述

添加按钮

Alt+Insert

点击此图标以添加下列可用任务之一：

  • 启动Web 浏览器 ：选择此选项即可启动浏览器。 在打开的对话框中，选择浏览器类型并提供起始 URL。 还需指定是否希望使用 JavaScript 调试器启动浏览器。

  • 运行外部工具 ：选择运行外部应用程序。 在打开的对话框中，选择您要运行的一个或多个应用程序。 如果它在 GoLand 中尚未定义，请添加其定义。

  • 运行另一个配置 ：选择执行另一个运行/调试配置，并等待其完成后再开始当前配置。 如果您想并行运行多个配置，请使用 compound run/debug configuration。

  • 运行File Watcher ：选择此选项以让 GoLand 应用所有当前活动的 文件监视器。

  • 运行远程外部工具 ：添加一个远程 SSH 外部工具。

  • 运行Grunt 任务 ：选择此选项来运行 Grunt 任务。

    在打开的 Grunt 任务 对话框中，指定定义所需任务的 Gruntfile.js ，选择要执行的任务，并指定传递给 Grunt 工具的参数。

    指定 Node.js 解释器的位置、传递给它的参数以及 grunt-cli 包的路径。

  • 运行gulp 任务 ：选择此选项以运行 Gulp 任务。

    在打开的 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 自行打开相应的工具窗口。

启动运行配置

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

  • 如果运行配置已在 Run widget 中选择，请点击其旁边的 或按 Shift+F10。

  • 如果您想选择另一个运行配置，请点击 Run widget。 在打开的菜单中，点击您想启动的运行配置旁的 。

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

共享运行/调试配置

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

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

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

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

    您可以配置任何位置，除非需要与 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。 此文件夹下的 运行/调试 配置将被移动到相应 运行/调试 配置类型的根目录下。

最后修改日期： 2025年 12月 5日
运行内置 IDE 宏