GoLand需手动配置GOROOT、GOBIN等环境变量，否则导致项目报错、补全失效、调试失败；必须通过终端验证路径并重启IDE生效。
GoLand 不会自动识别你系统里装好的 Go，GOROOT 必须手动填对，否则新建项目直接报错、代码不补全、gopls 启动失败——这不是 IDE 问题，是路径没配准。
怎么确认并填对 GOROOT
别信 Auto-detect。它在多版本共存（比如用 asdf 或 goenv）时大概率选错。打开终端执行：
go env GOROOT
复制输出的完整路径，粘贴进 GoLand 的 Settings → Go → GOROOT，点 + 号添加。常见路径有：
-
/usr/local/go（macOS/Linux 默认安装） -
C:\Go（Windows MSI 安装） -
~/.asdf/installs/golang/1.22.6（asdf 用户）
填完后，重启 GoLand 或 Reload project，看右下角是否显示 Go 版本号。不显示？说明路径错了或 go 命令本身不可用——先在终端跑 go version 验证。
立即学习“go语言免费学习笔记（深入）”；
为什么 GOBIN 在 PATH 里比 GOPATH 还重要
GoLand 依赖 gopls（语言服务器）和 dlv（调试器）提供跳转、补全、断点功能。它们不是 IDE 自带的，而是通过 go install 装到 GOBIN 目录下的。如果 GOBIN 没进系统 PATH，IDE 就找不到这些命令。
验证方式：终端执行
which gopls
如果无输出，运行：
在 Go 中使用 google/wire 实现编译时依赖注入——wire.NewSet、wire.Build、wire.Bind（接口→实现）、wire.Struct、wire.Value、wire.Interface
go install golang.org/x/tools/gopls@latest
再检查 go env GOBIN 输出，并把该路径加进系统 PATH（macOS/Linux 改 ~/.zshrc，Windows 改系统环境变量）。改完记得新开终端或 source ~/.zshrc。
新建项目时 go mod init 失败的三个硬性条件
点击 New Project → Go Module 却卡住、报 cannot find module providing package，通常不是 IDE 故障，而是当前目录不满足模块初始化前提：
- 路径不能含中文、空格或特殊符号（如
~/Desktop/我的项目→ 改成~/go/src/hello） - 当前目录不能在
$GOPATH/src下（旧 GOPATH 模式会干扰模块推导） - 终端里
go env GO111MODULE必须返回on；若为auto或off，执行go env -w GO111MODULE=on
补救：切到干净路径（比如 ~/tmp/myapp），终端执行 go mod init myapp，再用 GoLand 打开该文件夹。
dlv 调试器启动失败的典型现象和解法
点 Debug 报 could not launch process: fork/exec /path/to/dlv: no such file or directory，说明 GoLand 找不到 dlv，或者版本与当前 Go 不兼容。
操作步骤：
- 终端执行
go install github.com/go-delve/delve/cmd/dlv@latest（注意不是go get） - 确认
dlv version输出的 Go 版本号 ≥ 当前项目使用的 Go 版本（如项目用 1.22，dlv编译时需用 ≥1.22 的 Go） - GoLand 中进入
Settings → Go → Tools，检查Delve path是否为空；若为空，点右侧文件夹图标，手动定位到GOBIN/dlv
别忽略 dlv 的二进制权限（Linux/macOS 下可能需要 chmod +x）；Windows 用户注意不要混用 WSL 和原生 cmd 的 dlv。
最常被跳过的一步：改完任何环境变量（GOROOT、GOBIN、GOPROXY）后，必须关掉所有 GoLand 窗口再重开——缓存不会自动刷新，IDE 读的还是旧值。
