GoLand 2025.2 Help

WSL

WSLWSL 2 )即 Windows Subsystem for Linux,是一个用于在 Windows 10 及更高版本上原生运行 Linux 可执行文件的兼容层。 目前支持多种 Linux 发行版 ,例如 Ubuntu、OpenSUSE 和 SLES。

配置 WSL

  1. 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. 从主目录下载 tar 包。

    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 文件系统中的项目,并像操作其他项目一样进行操作。

  • 单击 浏览 按钮并导航到希望在 WSL 文件系统中打开的目录。 也可以手动输入 \\wsl$ 项目位置的路径。

    在 WSL 中打开现有项目

当您在项目中 运行代码时,该代码将在 WSL 中运行。 如果打开运行配置,请注意 GoLand 将 WSL 视为本地机器。

运行配置

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

为项目使用 WSL 环境

您可以在 Windows 上 创建打开项目,然后使用 run targets 在 WSL 中运行已编译代码。 这对于进行跨平台开发可能非常有帮助。

运行工具窗口:WSL 输出

创建 WSL 配置

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

  2. 添加目标位置 窗口中选择 WSL

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

  4. 请检查 WSL 的 Go 运行时配置是否已正确检测,然后单击 完成

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

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

    • GOPATH :定义工作区根目录的路径。 根目录必须包含 bin pkg src 子目录。 (例如, /home/goprojects

    • 版本 :Go SDK 的版本号(例如, go1.15.8 linux/amd64)。 GoLand 会通过运行 go version 自动检测此信息。

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

      要在目标上运行,GoLand 需要将以下实体上传到目标:源代码文件、工作目录中的文件、已编译的二进制文件和 delve。 如果您未在 附加设置 中指定路径,IDE 将创建随机目录来存储上述文件。 请查看下方的屏幕截图,其中展示了用于源文件和可执行文件的随机生成目录。

      您可以指定以下选项:

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

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

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

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

    创建 WSL 配置

防火墙配置

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

配置防火墙设置

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

    将防火墙还原为默认设置
  2. 执行以下命令以允许使用 WSL 的连接:

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

    使用以下命令检查精确的接口名称,例如 vEthernet (WSL)vEthernet (WSL2) ,或者若已重命名则为其他名称:

    Get-NetAdapter
  3. 然后执行命令以重新应用防火墙规则:

    Get-NetFirewallProfile -Name Public | Get-NetFirewallRule | where DisplayName -ILike "GoLand*" | Disable-NetFirewallRule
  4. 现在 启动调试器会话。 当出现 Windows 防火墙 弹窗时,选中 公共网络 复选框。

最后修改日期: 2025年 9月 26日