GoLand 2025.2 Help

运行／调试配置

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

有两种 运行/调试 配置类型：

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

  • 永久 — 通过模板显式创建或通过保存临时配置生成。 永久配置将作为项目的一部分保留，直到被移除。

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

永久配置拥有不透明图标，而临时配置的图标则为半透明。带红色叉号的配置图标表示配置设置存在错误。 带红色叉号的配置图标表示配置设置存在错误。

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

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

创建临时运行／调试配置

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

从编辑器运行

如果您的程序无需传递参数，也不需要在启动前执行特定操作，则可以直接从编辑器运行程序。

  • 点击靠近 main 函数的 边距 中的 ，然后选择 运行。

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

创建永久运行／调试配置

GoLand 提供以下方式用于创建永久运行／调试配置：

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

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

    保存临时运行配置

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

    正在保存临时配置

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

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

  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 查看可用包的列表。

“Package path”字段的自动补全

输出目录(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 的详细信息，请参阅 Package testing。

  • gocheck ：用于扩展 go check 的功能并运行更复杂的测试。 如需了解有关 go check 的详细信息，请参阅 go check。

  • gobench ：用于运行性能测试。 如需了解有关 gobench 的详细信息，请参阅 Package testing: Benchmarks。

  • 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 仅会执行符合所提供正则表达式的测试、示例和模糊测试。 对于测试，该表达式按斜杠（/ ）分隔为一系列未被括号包裹的正则表达式。 测试标识符的每个部分都必须与该序列中的对应部分匹配。

例如，要执行一个名为 add_positive_and_negative 的特定测试，且它在 TestAdd 表测试中，可使用以下正则表达式： ^\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 中定义，请添加其定义。

  • 运行另一个配置 ：选择以执行另一个运行∕调试配置，并在当前配置启动前等待其完成。 如果希望并行运行多个配置，请使用 复合运行∕调试配置。

  • 运行File Watcher ：选择此选项让 GoLand 应用所有当前处于活动状态的 File Watchers。

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

  • 运行Grunt 任务 ：选择该选项以运行 Grunt 任务。

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

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

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

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

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

  • 运行npm 脚本 ：选择此选项以执行 npm 脚本。

    在打开的 NPM 脚本 对话框中，指定 npm run∕debug 配置设置。

  • 编译TypeScript ：选择以运行内置 TypeScript 编译器，从而确保对 TypeScript 代码所做的所有更改反映在生成的 JavaScript 文件中。 在打开的 TypeScript 编译设置 对话框中，选择或取消选择 检查错误 复选框，以配置在检测到错误时编译器的行为：

    • 如果选中 检查错误 复选框，编译器将显示所有错误，并且运行配置不会启动。

    • 如果取消选中 检查错误 复选框，则编译器将显示所有检测到的错误，但仍会启动运行配置。

  • 运行Go 命令 ：选择此项以在运行程序之前执行 Go 命令。 例如，您可以运行 go generate 来在编译之前生成源代码。 在 编辑Go 命令任务 对话框中，您可以使用自动补全。 自动补全支持以下命令： generate、 vet、 test -i。 您可以使用自己的命令。

  • 断开数据源 ：如果您希望在运行/调试配置运行之前中断与数据源的连接，请选择此选项。

移除按钮

Alt+Delete

单击此图标可从列表中移除所选任务。

编辑

Enter

单击此图标可编辑所选任务。 在打开的对话框中进行所需更改。

方法上移

方法下移

Alt+Up

Alt+Down

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

显示此页面

选中此复选框可在实际开始运行/调试配置之前显示运行/调试配置设置。

激活工具窗口

默认情况下，选中该复选框，并在您启动运行/调试配置时打开 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 并通过如下修改 .gitignore 来忽略 .idea ：

    /.idea/* !/.idea/runConfigurations

运行／调试配置模板

所有运行/调试配置均基于模板实现启动逻辑，定义参数列表及其默认值。 可用模板列表 是在安装时预定义的，只能通过 插件 进行扩展。 不过，您可以在每个模板中编辑默认参数值，以便更轻松地设置新的运行/调试配置。

配置模板的默认值

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

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

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

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

    更改运行／调试模板

运行／调试配置文件夹

当存在多个同类型的 运行/调试 配置时，您可以将其分组放置于文件夹中，以便更方便地访问。

为运行／调试配置创建文件夹

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

  2. 在 运行/调试配置 对话框中，选择一个配置类型，然后单击工具栏中的 新建文件夹图标。 已为所选类型创建一个新的空文件夹。

  3. 在右侧的文本字段中指定文件夹名称，或保留默认名称。

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

  5. 应用更改。 如果文件夹为空，则不会保存。

当您不再需要某个文件夹时，可以使用 Delete 将其删除。 归入该文件夹的 运行/调试 配置将被移至相应 运行/调试 配置类型的根目录。

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