GoLand 2026.3 Help

运行目标

您可以直接从 GoLand 在 SSH 服务器、WSL 或 Docker 容器中运行 Go 构建和 Go 测试配置。俔},{

运行目标可用于在选定环境中测试代码。

先决条件

要在目标上运行 Go 代码,请为目标配置 Go 运行时。

在 Go Build 或 Go Test 配置中,从 运行 列表中选择目标。 然后像在本地一样启动该配置。

您可以在同一目标上运行多个配置。 还可以为项目设置默认目标。

为项目设置默认目标

  1. 点击 运行 | 管理目标。

  2. 从 项目默认目标 列表中选择要用于项目的目标。

支持的运行/调试配置类型

以下 run/debug configurations 可以在远程目标上运行:

  • Go Build

  • 运行测试

创建运行/调试配置

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

  2. 在 运行/调试配置对话框中,点击工具栏上的 添加 按钮 添加按钮 或按 Alt+Insert。

  3. 请选择一种 支持的运行/调试配置类型。

  4. 如果您已经定义目标,请从 运行 菜单中选择。 否则,点击 管理目标… 以添加新的目标。 如需了解有关配置特定目标类型的更多信息,请参考以下程序:

您还可以在运行/调试配置模板中配置运行目标,这样下次创建该类型的新配置时,其参数就已经有了所需的值。 欲了解更多信息,请参阅 配置模板的默认值。

运行

在远程目标上运行应用程序的过程与在本地运行它的过程相同:

  1. 在主工具栏上选择运行/调试配置。

  2. 点击 “运行”按钮 或按 Shift+F10。

选择 在远程目标上构建 后,GoLand 会将所需源文件复制到目标,并在那里构建应用程序或测试。 当所选 Go SDK 位于 WSL 中时,GoLand 也会在目标上进行构建。 否则,它会在本地构建,并将编译后的可执行文件复制到目标。

目标类型

一个 target描述了应用程序运行环境的配置。

您可以创建以下目标:

当您创建远程目标时,GoLand 会自动检测远程环境中可用的配置。 如果需要,您可以手动配置其他配置。

WSL

  1. 在主菜单中,点击 运行 | 管理目标。

  2. 在 添加目标于 窗口中,选择 WSL。

    从运行列表中选择 wsl
  3. 在 新目标​目录​ 向导中,从 Linux 发行版 列表中选择您的 Linux 发行版。 如果发行版已自动检测到并且内省通过,请点击 下一个。

  4. 检查 WSL 的 Go 运行时配置是否正确检测到,然后点击 完成。

    或者,输入您自己的设置。

    • Go 可执行文件 :Go 可执行文件的路径(例如, /usr/local/go/bin/go )

    • GOPATH :目标的 GOPATH。 GoLand 通过运行 go env GOPATH 自动检测此值。

    • 版本 :Go 版本。 GoLand 通过运行 go version 自动检测此信息。

    • 附加设置 :一组设置,允许您设置源代码文件和可执行文件的目录。

      要在目标上运行,GoLand 会上传源文件、工作目录中的文件、编译后的可执行文件以及 Delve。 如果未在 附加设置 中指定路径,GoLand 会为源文件和可执行文件创建目录。

      您可以指定以下选项:

      • 项目源目录 :目标上上传源代码文件的目录。

      • 已编译可执行文件目录 :目标上用于存储代码生成的可执行文件的目录。

    检查 WSL 的 Go 运行时配置
  5. 在 运行目标 对话框中,点击 项目默认目标 列表并选择创建的配置。

    运行工具窗口:WSL 输出
  6. 运行您的应用程序.

    创建 WSL 配置

SSH

  1. 选择是否使用现有的 SSH 配置或创建新的配置:

    从 SSH 列表中选择一个现有的 SSH 配置,然后点击 下一个。 有关配置 SSH 的更多信息,请参阅 创建 SSH 配置。

    1. 请输入 SSH 服务器的 IP、监听 SSH 连接的端口,以及您将代表其在服务器机器上运行应用程序的用户名称。 点击 下一个。

    2. 请等待连接建立。 如果存在具有凭证的代理,则无需额外配置。 否则,请选择验证方法并提供所需的值:

      • 密码 :输入密码。

      • 密钥对(OpenSSH 或 PuTTY) :要应用此身份验证方法,您必须在客户端计算机上拥有私钥,并在远程服务器上拥有公钥。 GoLand 支持通过 OpenSSH 实用程序生成的私钥。

        指定存储您的 private key的文件路径,并在相应的字段中输入密码短语(如果有)。 要让 GoLand 记住密码短语,请选中 保存密码短语 复选框。

      点击 下一个。

  2. 等待 SSH 服务器自检完成。 在此步骤中,GoLand 尝试识别环境中可用的语言配置。 点击 下一个。

  3. 配置以下属性:

    • 使用 rsync :切换此选项以使用 rsync进行文件传输。 建议这样做,因为它通常会加快文件复制的速度。

    • 目标上的项目路径 :服务器上用于存储项目文件的路径。

  4. 设置 Go 可执行文件的路径,并根据需要设置 GOPATH。 GoLand 会自动检测 Go 版本。 版本 字段为只读。

    以下 Go 配置设置可用:

    • Go 可执行文件 :Go 可执行文件的路径(例如, /usr/local/go/bin/go )

    • GOPATH :目标的 GOPATH。 GoLand 通过运行 go env GOPATH 自动检测此值。

    • 版本 :Go 版本。 GoLand 通过运行 go version 自动检测此信息。

    • 附加设置 :一组设置,允许您设置源代码文件和可执行文件的目录。

      要在目标上运行,GoLand 会上传源文件、工作目录中的文件、编译后的可执行文件以及 Delve。 如果未在 附加设置 中指定路径,GoLand 会为源文件和可执行文件创建目录。

      您可以指定以下选项:

      • 项目源目录 :目标上上传源代码文件的目录。

      • 已编译可执行文件目录 :目标上用于存储代码生成的可执行文件的目录。

Docker

  1. 选择或配置 Docker 服务器 ,如 启用 Docker 支持。 中所述。

  2. 在 Windows 和 macOS 上,允许 Docker 访问项目文件夹以及容器使用的任何其他本地文件夹。 如需更多信息,请参阅 官方 Docker 文档。

  3. 选择您是要在本地构建镜像还是从 Docker 注册表拉取。

    • Dockerfile :用于构建映像的 Dockerfile。

    • 上下文文件夹​ :在构建过程中,可供 Docker 守护程序访问其内容的文件夹,稍后将在镜像文件系统中使用。

    • 每次运行代码前自动重建镜像 :当此选项设置后,每次运行代码时,图像都会重建。 否则,GoLand 将使用已有的镜像(如果有的话)。

    此外,您可以指定以下内容:

    • 镜像标记 :指定构建镜像的名称和标签。 类似于使用 -t 选项与 docker build。

    • 构建选项 :指定 docker build 命令的任意选项。

    • 构建参数: 重写默认的构建时变量。 与使用 --build-arg 选项 docker build 类似。

    • 运行选项 :指定 docker run 命令的任意选项。

    • 镜像标记 :指定从镜像仓库拉取镜像的完整坐标。 默认情况下,如果仅指定 repository,则将使用 :latest 标签。

    • 运行选项 :指定 docker run 命令的任意选项。

  4. 等待容器自检完成。 在此步骤中,GoLand 尝试识别环境中可用的语言配置。 点击 下一个。

  5. 设置 Go 可执行文件的路径,并根据需要设置 GOPATH。 GoLand 会自动检测 Go 版本。

    以下 Go 配置设置可用:

    • 目标上的项目路径 :服务器上用于存储项目文件的路径。

    • Go 可执行文件 :Go 可执行文件的路径(例如, /usr/local/go/bin/go )

    • GOPATH :目标的 GOPATH。 GoLand 通过运行 go env GOPATH 自动检测此值。

    • 版本 :Go 版本。 GoLand 通过运行 go version 自动检测此信息。

    • 附加设置 :一组设置,允许您设置源代码文件和可执行文件的目录。

      要在目标上运行,GoLand 会上传源文件、工作目录中的文件、编译后的可执行文件以及 Delve。 如果未在 附加设置 中指定路径,GoLand 会为源文件和可执行文件创建目录。

      您可以指定以下选项:

      • 项目源目录 :目标上上传源代码文件的目录。

      • 已编译可执行文件目录 :目标上用于存储代码生成的可执行文件的目录。

Docker Compose

您可以将单个 Docker Compose 服务用作运行目标。

  1. 选择或配置 Docker 服务器 ,如 启用 Docker 支持。 中所述。

  2. 对于 Windows 和 macOS,请确保 Docker 可以访问工作流中使用的所有文件夹,例如项目文件夹。 如需更多信息,请参阅 官方 Docker 文档。

  3. 指定 Docker Compose 配置文件,选择所需的服务,并提供任何附加的环境变量。 点击 下一个。

  4. 请等待 Docker Compose 服务内省完成。 在此步骤中,GoLand 尝试识别环境中可用的语言配置。 点击 下一个。

  5. 设置 Go 可执行文件的路径,并根据需要设置 GOPATH。 GoLand 会自动检测 Go 版本。

    以下 Go 配置设置可用:

    • 目标上的项目路径 :服务器上用于存储项目文件的路径。

    • Go 可执行文件 :Go 可执行文件的路径(例如, /usr/local/go/bin/go )

    • GOPATH :目标的 GOPATH。 GoLand 通过运行 go env GOPATH 自动检测此值。

    • 版本 :Go 版本。 GoLand 通过运行 go version 自动检测此信息。

    • 附加设置 :一组设置,允许您设置源代码文件和可执行文件的目录。

      要在目标上运行,GoLand 会上传源文件、工作目录中的文件、编译后的可执行文件以及 Delve。 如果未在 附加设置 中指定路径,GoLand 会为源文件和可执行文件创建目录。

      您可以指定以下选项:

      • 项目源目录 :目标上上传源代码文件的目录。

      • 已编译可执行文件目录 :目标上用于存储代码生成的可执行文件的目录。

2026年 11月 9日