GoLand 2026.3 Help

WSL

WSL （WSL 2 ）——Windows Subsystem for Linux——是一个兼容层，用于在 Windows 10 及更高版本上本地运行 Linux 二进制可执行文件。 目前，它支持若干 Linux 发行版 ，例如 Ubuntu、OpenSUSE 和 SLES。

配置 WSL

  1. 在 Windows 电脑上，从 Microsoft Store 下载并安装一个 WSL 发行版（例如 Ubuntu）。

    此步骤请务必使用至少 Windows 10 或更高版本，并安装最新的“秋季创作者更新”（最低版本 1709，构建 16299.15）。 请参阅官方指南 Install the Windows Subsystem for Linux了解详细说明。

    要使用 WSL 2 ，您的 Windows 版本应为 10 版本 18917 或更高版本。 请遵循 这些指示来切换分布式。

    请注意，GoLand 不支持 旧版 WSL ，而您可能在将系统升级到 Windows 10 构建 16299.15 或更高版本之前安装过。 在这种情况下，您需要更新您的 WSL 发行版。

  2. 运行 Linux 发行版。

    首次启动时，系统可能会提示您启用 Windows 可选功能。 在这种情况下，您需要执行以下操作：

    • 以管理员身份打开 Windows PowerShell 并运行

      Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux

    • 重新启动您的计算机。

  3. 从您的主目录下载 tarball。

    wget https://go.dev/dl/go1.22.0.linux-amd64.tar.gz

  4. 将归档文件解压到 /usr/local 。

    tar -C /usr/local -xzf go1.22.0.linux-amd64.tar.gz

  5. 在您的主目录（cd ~ ）中，创建 go 文件夹。

    mkdir go

  6. 配置 GOPATH 和 GOROOT。

    export GOROOT=/usr/local/go
    export GOPATH=$HOME/go
    export PATH=$PATH:/usr/local/go/bin

您可以创建一个项目并将其存储在 WSL 环境中，从 WSL 文件系统中打开一个项目，并在 WSL 中进一步开发您的项目。

在 WSL 文件系统中创建一个新项目

  1. 安装并运行 GoLand，就像您通常在 Windows 上本地运行一样。

  2. 在欢迎屏幕上，点击 新项目。

  3. 点击 浏览 按钮并导航到 WSL 中您想要创建新项目的目录。

    在 选择基础目录 对话框中，您可以点击 新建文件夹 按钮（新建文件夹图标 ）为项目创建一个文件夹。

    WSL 的项目位置将显示以 \\wsl$ 开头的 WSL 文件系统的绝对路径。

  4. 点击 创建。

    GoLand 会创建一个位于 WSL 中的项目，您可以在不离开 IDE 的情况下在 WSL 环境中开发和构建项目。

    在 wsl 中创建项目文件夹

在 WSL 文件系统中打开项目

在 GoLand，您可以直接打开存储在 WSL 文件系统中的项目，并像处理其他项目一样进行操作。

  1. 请点击 打开 在 欢迎屏幕或从主菜单中选择 文件 | 打开。

  2. 在打开的对话框中，选择 WSL 文件系统中包含待打开项目的文件夹，或手动输入项目位置的路径。

    路径语法为 \\wsl.localhost\DistributionName ，其中 DistributionName 是您的 Linux 发行版名称，例如 Ubuntu、Debian、Arch 等。

    在 wsl 中打开现有项目

配置项目位置

您可以确保创建或打开的任何项目都使用适当的 WSL 位置。

  1. 按下 Ctrl+Alt+S 打开设置，然后选择 外观与行为 | 系统设置。

  2. 在 项目 部分下的 默认项目目录 字段中，指定相应的 WSL 目录，然后点击 确定 以保存更改。

    默认项目目录

    从现在起，每当您 创建、 打开或 克隆项目时，默认会选择指定的目录。

当您 运行项目中的代码时，它是在 WSL 中运行的。 如果您打开运行配置，请注意 GoLand 指的是 WSL 作为本地机器。

运行配置

代码执行结果显示在 运行 工具窗口中。

为项目使用 WSL 环境

您可以 创建或 打开您的项目本地在 Windows 上，然后使用 运行目标在 WSL 中运行已编译的代码。 这可能对 跨平台开发 有帮助。

运行工具窗口：WSL 输出

创建 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 配置

防火墙配置

您需要执行以下步骤以确保项目构建正常运行。

配置防火墙设置

  1. 以管理员身份运行 Windows PowerShell。

    将防火墙恢复为默认设置

  2. 请使用以下命令检查确切的接口名称，例如 vEthernet (WSL)、 vEthernet (WSL2) ，如果您已将其重命名，则可能为其他名称：

    Get-NetAdapter

  3. 执行以下命令以允许使用 WSL 进行连接：

    New-NetFirewallRule -DisplayName "WSL" -Direction Inbound -InterfaceAlias "vEthernet (WSL)" -Action Allow

  4. 然后执行命令以更新防火墙规则：

    Get-NetFirewallProfile -Name Public | Get-NetFirewallRule | where DisplayName -ILike "GoLand*" | Disable-NetFirewallRule

  5. 现在 start the debugger session。 当 Windows 防火墙 弹出窗口出现时，选择 公共网络 复选框。

WSLg

WSLg 允许您运行 Linux GUI 应用程序，并在 Windows 桌面上显示其输出。

不建议通过 WSLg 运行 GoLand。 GoLand 已提供原生 WSL 集成，这是首选方法。

请记住以下事项：

  • WSLg 在渲染、弹出窗口、窗口管理、输入方法和桌面集成方面存在限制。

  • 对于通过 WSLg 运行 GoLand，我们不提供专门支持、安装指导、入门引导或产品特定修复。

要了解如何打开项目，请参阅 在 WSL 文件系统中打开项目 ；如果您想创建新项目，请参阅 在 WSL 文件系统中创建一个新项目。

2026年 11月 9日
IDE 脚本控制台外部工具