GoLand中go.goroot必须手动在Project Structure→Project SDK中指定真实Go安装根目录（如C:\go1.25.10），不识别.gvmrc或.go-version等版本管理文件，且不读系统GOROOT变量，改后须重启IDE验证生效。
GoLand 里 go.goroot 必须手动指定，不读 .gvmrc 或 .go-version
VS Code 的 Go 扩展会尝试读取项目根目录下的 .go-version（voidint/g）或 .gvmrc（gvm），但 GoLand 完全不识别这两类文件。它只认自己设置里的 GOROOT 路径。哪怕你用 gvm use go1.25.10 切换了终端版本，GoLand 启动时仍按旧路径找 SDK，导致：go fmt 报错、跳转定义失败、go doc 查不到内容。
正确做法是：打开 File → Project Structure → Project Settings → Project → Project SDK，点击右侧 + 添加新 SDK，然后指向你解压好的 Go 版本目录（如 C:\go1.25.10 或 /usr/local/go-1.25.10）。每个项目可单独绑定一个 SDK，无需全局切换。
- 添加后，GoLand 会自动检测该 SDK 下的
bin/go、src、pkg是否完整——缺pkg目录会导致调试器（delve）启动失败 - 如果 SDK 列表里出现 “
Go SDK (invalid)”，说明路径下没有bin/go或权限不足（Windows 上尤其注意是否为管理员解压） - Mac 用户要注意系统兼容性：Go 1.25+ 要求 macOS 12+，在 Monterey 之前系统上选
go1.24.11等兼容版本，否则启动时报dyld: Symbol not found: _SecTrustCopyCertificateChain
Windows 下别信 GOROOT 系统变量，GoLand 只读自己配置的路径
很多教程教你在 Windows 系统环境变量里设 GOROOT=C:\go1.22，再指望 GoLand 自动继承——这基本无效。GoLand 启动时并不解析系统 GOROOT，它只看你项目 SDK 设置里填的绝对路径。而且一旦你改了系统变量，已启动的 GoLand 实例不会刷新，必须重启 IDE 才可能重新探测（但大概率还是忽略）。
更麻烦的是：如果你用批处理脚本（如 switch-go1.22.bat）临时修改当前 CMD 的 GOROOT 和 PATH，GoLand 根本看不到这个会话级变量。它只读用户/系统级环境变量，且仅在启动瞬间读一次。
立即学习“go语言免费学习笔记（深入）”；
- 解决方案就一个：在 GoLand 的 SDK 配置界面里，老老实实点选或输入完整路径，比如
C:\go1.25.10，不要用C:\go这种软链接路径（除非你确认该链接始终有效且 IDE 有读取权限） - 想快速切换？直接删掉旧 SDK，再加新路径——GoLand 允许一个项目绑定多个 SDK，但只激活一个；切换时只需在下拉框里选另一个，不用删
- 避免在 PATH 中堆多个
go*/bin，否则终端里which go返回的版本和 GoLand 用的版本可能不一致，排查问题时容易误判
Mac/Linux 用户慎用 asdf 或 gvm 自动生成的符号链接路径
asdf global golang 1.25.10 或 gvm use go1.25.10 --default 通常会让 go 命令指向一个软链接（如 /usr/local/go/bin/go），但 GoLand 的 SDK 配置要求填写「真实 SDK 根目录」，不是软链接本身。如果你填了 /usr/local/go，它会去找 /usr/local/go/src，而实际源码可能在 /Users/xxx/.asdf/installs/golang/1.25.10/src，结果报 SDK is not valid。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
正确路径应该是符号链接最终指向的真实目录。可用命令确认：
readlink -f /usr/local/go
输出类似 /Users/xxx/.asdf/installs/golang/1.25.10，就把这个路径填进 GoLand SDK 设置。
-
asdf不改GOROOT，所以go env GOROOT显示的就是真实路径，可直接复制粘贴 -
gvm在 M1/M2 Mac 上有兼容问题，安装常卡住或编译失败，推荐换vfox或直接用asdf - Linux 用户若用
gvm，确保安装时用了--binary参数（跳过编译），否则在最小化镜像里容易因缺 gcc 失败
切完 SDK 后，go mod 缓存和 GOPROXY 得跟着换
GoLand 指定 SDK 后，它调用的 go 命令确实来自那个版本，但 go mod download 仍依赖当前 shell 的环境变量。如果你没在对应 SDK 初始化时配好 GOPROXY 和 GOSUMDB=off，执行 go mod tidy 会卡在 proxy.golang.org 或校验失败。
这不是 GoLand 的锅，而是 Go 工具链本身行为：每个 go 二进制只管执行，不管理环境。所以每次换 SDK 后，建议在终端里跑一次：
go env -w GOPROXY=https://goproxy.cn,direct<br>go env -w GOSUMDB=off
这些设置写入的是当前用户的 go env 配置，对所有 Go 版本生效（除非你用 go env -u 取消）。但注意：GOPATH 和 GOMODCACHE 是路径型变量，不同 Go 版本共用同一缓存没问题，没必要重复设。
- 国内开发务必设
GOPROXY，否则go mod基本不可用 - 如果项目用了私有模块，
GOPROXY要加上企业内网地址，格式如https://goproxy.cn,https://intranet.example.com - GoLand 内置终端（Terminal）默认继承系统环境变量，但调试器（Run/Debug Configurations）启动时不一定——最好统一在用户级
go env里设死
pkg 目录（导致 delve 启动失败）、go 二进制与 macOS 系统版本不匹配（报 dyld 错误）、以及 GOPROXY 没设导致 go mod 卡住——这三处一出问题，GoLand 界面可能毫无提示，只在 Terminal 或 Run 窗口里闪一下错误就消失。 
