GoLand 2026.3 Help

运行中

如果为您的 项目设置了 GOROOT ,您可以直接从 GoLand 运行应用程序。

快捷方式

从编辑器运行

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

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

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

可自定义的方式

  1. 点击 ,位于 边距 中靠近 main 函数的位置,然后选择 修改运行配置。

  2. 根据需要修改运行/调试配置。 例如,如果您需要使用参数运行程序,请将参数添加到 程序参数 字段。

启动运行配置

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

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

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

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

当应用程序启动时,您可以在 运行 工具窗口中查看其输出并与其交互。 每次 run/debug configuration运行时都会创建一个单独的选项卡。

有关工具窗口及其管理的更多信息,请参见 工具窗口 主题。

运行/调试配置中的字段列表

右侧窗格中显示的字段显示了所选配置类型的默认设置。

名称

描述

运行类型

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

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

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

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

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

包路径

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

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

输出目录

可执行文件的目录。

在远程目标上构建

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

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

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

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

构建后运行

在构建后执行应用程序。

在输出控制台中模拟终端

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

工作目录

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

环境

应用程序的环境变量。

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

Go tool 参数

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

使用所有 custom build tags

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

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

程序参数

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

需要使用sudo运行

为该应用程序授予 sudo 权限。

模块

当前模块名称。

启动前

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

存储为项目文件

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

重新运行应用程序

  • 在 运行 工具窗口的工具栏上,点击 重新运行按钮重新运行 或按 Shift+F10。

运行多个任务

  • 要同时运行或调试多个任务,请在工具栏中打开运行小部件菜单,并按住 Ctrl 键选择相应的运行/调试配置。

有关使用单个运行/调试配置启动多个任务的信息,请参阅 运行/调试多个目标。

服务 工具窗口显示用户启动的多个 go build 运行/调试配置。 要隐藏特定配置(例如 CLI 工具),请取消选中 Go Build 树项的复选框。

暂停和中止应用程序

当您停止程序时,其进程会被中断并立即退出。 当您暂停程序时,它将继续在后台运行,但其输出将暂停。

停止程序

  • 在 运行 工具窗口中,点击工具栏上的 停止按钮停止。 或者,按 Ctrl+F2 并选择要停止的进程。

暂停程序输出

  • 在 运行 工具窗口中右键点击,然后从上下文菜单中选择 暂停输出。 使用相同的切换来恢复程序。

显示正在运行的进程

您可以查看所有活动运行或调试会话的列表,并在它们之间导航。

  • 转到 运行 | 显示运行列表。 在编辑器的右上角,GoLand 显示所有活动应用程序的列表。

运行、调试或测试代码时,GoLand 会使用匹配的永久运行/调试配置。 如果不存在匹配的配置,则会创建一个临时配置。

临时配置包含 GoLand 执行该操作所需的详细信息。 通常,这足以运行或调试代码。 可以再次使用它运行,或将它保存以供将来使用。

根据您的目的,您可以编辑现有配置或创建新配置。 有关编辑配置的更多信息,请参阅 运行/调试配置。

您可以在 运行工具窗口中查看正在运行的应用程序的输出。 每个应用程序的输出显示在其自己的选项卡中,选项卡名称与相应的 运行/调试配置相同。

2026年 11月 9日