GOROOT必须填Go安装根目录（如/usr/local/go或C:\Go），不可填bin子目录，否则GoLand运行按钮变灰、import标红、跳转失效；填完需重启IDE，且GOBIN须置于PATH最前、代理配置需含direct、dlv版本须与Go小版本严格对齐。
GOROOT必须填根目录，填错就灰按钮
GoLand右上角运行按钮灰掉、import标红、跳转失效，90%是GOROOT路径填错了。它不能指向/usr/local/go/bin或C:\Go\bin，必须是Go安装根目录——里面得有src、pkg、bin三个文件夹。
- macOS/Linux常见正确路径：
/usr/local/go（Homebrew装的可能是/opt/homebrew/opt/go/libexec） - Windows默认路径：
C:\Go，不是C:\Go\bin - 填完必须重启GoLand，点Apply或Reload project都不生效
- 验证方式：新建
main.go写fmt.Println("ok")，绿色三角亮起且无波浪线才算对
GOBIN要进PATH最前面，否则工具装了也用不上
go install装的工具（比如gopls、dlv、gofumpt）默认放进$GOBIN，但GoLand调用时只认PATH里第一个匹配的二进制。如果系统PATH里有旧版gopls，IDE就会用错版本，导致补全卡顿、跳转失败。
GoLand 2026.1.1
下载
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 统一设
GOBIN=$HOME/go/bin（Linux/macOS）或%USERPROFILE%\go\bin（Windows） - 把
$GOBIN加到PATH最前面，不是末尾 - 执行
go install golang.org/x/tools/gopls@latest后，在终端直接敲gopls version确认能跑 - GoLand里Settings → Go → GOPATH → GOBIN字段要显式填和环境变量一致的路径
代理必须带direct，不然私有模块永远拉不到
只配https://goproxy.cn会导致Go尝试从代理拉所有模块，包括本地路径或公司内网模块——它们根本不在代理上，结果就是go mod download卡住、go build报cannot find module。
- Settings → Go → Go Modules → Proxy填：
https://goproxy.cn,direct（逗号前后**不能有空格**） - 这个
direct告诉Go：“代理拿不到的，直接连原始地址”，对file://、git@、企业私有仓库都生效 - 删掉项目根目录的
go.work文件——它会强制启用多模块工作区，干扰单模块项目解析 - 改完后右键项目根目录 → Reload project（不是Sync），触发完整module加载
调试器dlv版本必须和Go小版本对齐
Go 1.22.x用dlv 1.21.x，或者Go 1.21.x用dlv 1.22.x，都会静默失败：断点不命中、进程秒退、控制台没输出，错误信息可能只有could not launch process这种模糊提示。
- 先查本地Go版本：
go version（比如go1.22.5） - 再装对应dlv：
go install github.com/go-delve/delve/cmd/dlv@v1.22.5（版本号对齐） - 在Run → Edit Configurations → Go Build里，Debugger选Delve，并手动指定Path to dlv为
$GOBIN/dlv - 测试：在main函数开头加
fmt.Println("break here")，打个断点，Debug运行看是否停住
GOROOT路径多一个/bin、GOBIN在PATH里排第二、代理漏了direct、dlv版本差一个小数点——这些细节不写进文档，新人花半天排查，老手反复解释。 
