goroot必须指向go安装根目录（如/usr/local/go），不可设为bin子目录或带尾部斜杠，否则go命令“半瘫痪”，表现为go version输出空、go env goroot错误、ide报“go sdk not found”等。
GOROOT设错会导致go命令“半瘫痪”
GOROOT必须指向Go安装根目录，不是bin子目录，也不能带尾部反斜杠。设错后常见现象是：go version能运行但输出空，go env GOROOT返回错误路径，或GoLand报“Go SDK not found”。
- Windows用户：在「系统变量」中新建/修改
GOROOT，值填完整路径（如D:\golang），别写成D:\golang\bin或D:\golang\ - macOS/Linux用户：检查
/usr/local/go是否存在，若装在别处（如~/go-1.26），需在~/.zshrc里加export GOROOT=~/go-1.26 - 务必确认
%GOROOT%\bin（Windows）或$GOROOT/bin（macOS/Linux）已加入PATH，否则go命令根本找不到 - 改完环境变量后，**必须关闭所有终端窗口再重开**，否则
PATH不会刷新
GO111MODULE=on不是可选项，是必选项
不设这个，go get和go list -m all会直接失效，报not in a module或modules disabled。模块模式从Go 1.16起默认启用，但环境变量未显式设为on时，某些IDE或旧脚本仍可能 fallback 到 GOPATH 模式。
GoLand 2026.1.1
下载
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 执行
go env -w GO111MODULE=on，一劳永逸 - 验证：运行
go env GO111MODULE，输出必须是on，不是auto或空 - 如果项目已有
go.mod却仍报错，先执行go clean -modcache清缓存
GOPROXY必须带,direct后缀
只设https://goproxy.cn会导致私有包、新版包或未同步镜像的包直接失败，因为Go不会回源官方仓库。国内用户几乎都踩过这个坑。
- 推荐配置：
go env -w GOPROXY=https://goproxy.cn,direct - 公司有内网代理时，顺序很重要：
go env -w GOPROXY=https://intra.example.com,goproxy.cn,direct - 别漏掉
GOSUMDB=off（尤其在离线或内网环境），否则go get可能卡在checksum校验
GoLand不继承系统PATH，必须手动指定GOROOT
即使终端里go version一切正常，GoLand也可能完全找不到Go SDK——它不读系统环境变量，也不自动探测PATH里的go。
- Settings → Go → GOROOT → 点
+→ 选实际安装根目录（如C:\Go或/usr/local/go），**不能选bin子目录** - 点
Apply后，**必须重启GoLand**，仅Reload project无效 - 验证：新建
main.go，写fmt.Println("ok")，右上角绿色三角亮起且无波浪线才算成功 - 如果调试器
dlv报错，先在终端运行go install golang.org/x/tools/gopls@latest，再检查GoLand的Settings → Go → Tools是否识别到gopls
auto、GOPROXY缺,direct、GoLand没重启——这些细节不验证，就永远在“看起来对”和“实际跑不通”之间反复横跳。
