GoLand 无法直接将 WSL2 的 GOROOT 用作 Windows 项目 SDK，因 Windows 无法正确解析 Linux 路径、软链接及大小写敏感性，导致导入错误、补全失效、调试失败；必须配置 WSL 运行目标并统一终端、构建、调试环境。
GoLand 能直接用 WSL2 的 Go 环境开发，但不能把 WSL2 里的 GOROOT 当作 Windows 项目 SDK 直接挂载——否则会报 Go SDK in WSL cannot be used for the Windows project。必须走「WSL 运行目标 + WSL Go runtime」这一路径，否则补全、调试、构建全失效。
为什么不能直接把 WSL 的 /usr/local/go 设为 GOROOT
GoLand 在 Windows 主体下运行时，会尝试在 Windows 文件系统中解析 Go 标准库路径、go.mod 依赖路径、符号链接等。而 WSL2 的 Linux 路径（如 /usr/local/go/src/fmt）对 Windows 层不可见，且跨子系统访问 /mnt/wsl 或 \wsl$ 会导致路径大小写敏感性丢失、软链接断裂、go list 解析失败等问题。实测中，即使强行指定，也会出现：
-
cannot find package "fmt"类型的导入错误 - 代码补全只显示基础类型，不识别自定义包或第三方模块
- 调试器无法断点到标准库源码（因为 GoLand 找不到对应 Windows 路径）
正确配置 WSL2 Go 运行目标的三步操作
核心是让 GoLand 把整个构建、运行、调试生命周期交给 WSL2 环境执行，而非仅“借用”它的 Go 二进制。
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 先确保 WSL2 已就绪：
wsl -l -v显示Ubuntu-22.04（或你用的发行版）状态为Running且VERSION是2 - 在 GoLand 中打开
Settings → Build, Execution, Deployment → Run Targets，点击+→WSL，选择你的发行版（如Ubuntu-22.04），保存 - 再进入
Settings → Go → Go Libraries，点击Add Library→WSL→ 同样选该发行版；此时 GoLand 会自动探测/usr/local/go或/usr/bin/go并加载其标准库索引
终端、构建、调试必须统一指向 WSL2 环境
光配 SDK 不够，终端和运行配置也得对齐，否则你会遇到「终端里 go run 成功，但 IDE 里 Run 按钮报错」这种割裂现象。
- 终端 Shell Path 改为：
wsl.exe ~（不是bash.exe或ubuntu.exe），这样新开终端默认进入 WSL 用户家目录，且环境变量完整 - 新建 Run Configuration 时，顶部「Run on」下拉框必须选你刚配好的 WSL 目标（如
WSL: Ubuntu-22.04），而不是默认的Local - 调试时，确认
Run → Debug弹出的配置里，Run on也是同一 WSL 目标；否则 Delve 会在 Windows 下启动，连不上 WSL2 中的进程
常见坑：GOPATH 和模块缓存位置不一致
WSL2 里 go env GOPATH 默认是 /home/username/go，而你在 Windows 侧用资源管理器打开 \wsl$Ubuntu-22.04homeusernamego 看到的只是视图——实际文件由 WSL2 内核管理。若你在 Windows 下手动往这个路径写入 pkg 或 bin，WSL2 可能无法识别或拒绝加载。
更稳妥的做法是：所有 Go 模块下载、构建产物、本地包安装（go install）全部在 WSL2 终端内完成。例如，在 GoLand 终端里执行：go mod download、go install github.com/cpuguy83/go-md2man@latest，这样缓存和二进制才真正落在 WSL2 文件系统里，被 GoLand 正确索引。
