goroot必须手动配置，不能依赖auto-detect；需在settings→go→goroot中粘贴真实安装路径（如/usr/local/go或c:\go），路径不可含中文、空格或波浪号，验证方式为新建main.go并能跳转fmt源码。
GOROOT 必须手动填，不能信 Auto-detect
GoLand 启动时提示 No Go SDK found，不是它找不到 Go，而是它压根不读系统 GOROOT 环境变量，也不信任“Auto-detect”按钮。尤其在用 asdf、gvm 或多版本共存时，自动检测大概率选错路径，甚至返回空。
必须手动指定：File → Settings → Go → GOROOT → +，然后粘贴真实安装路径：
-
/usr/local/go（macOS/Linux） -
C:\Go或D:\DevTools\Go（Windows，推荐非 C 盘）
别点 Browse —— 文件选择器容易误选子目录（比如选到 /usr/local/go/bin），导致后续 fmt 包无法识别、跳转源码失败。路径里含中文、空格或波浪号（~/）会静默失效，验证方式就一条：新建 main.go，写 fmt.Println("ok")，能 Ctrl+Click 跳进 fmt 源码才算对。
go mod init 失败？先看 GOPROXY 和 GO111MODULE 是否生效
报错 cannot find module providing package 或 go: downloading ... timeout，90% 不是网络问题，而是 CLI 和 GoLand 用的代理/模块开关不一致。
关键动作必须在终端执行，不是只填 IDE 设置：
- 运行
go env -w GOPROXY=https://goproxy.cn,direct（国内）或go env -w GOPROXY=https://proxy.golang.org,direct（海外） - 确认
go env GO111MODULE输出为on；若为auto或off，执行go env -w GO111MODULE=on - 项目路径必须是干净英文目录，且不能在旧式
GOPATH/src下（比如C:\Users\xxx\go\src\myapp），否则模块初始化会冲突
已有 go.mod 但 GoLand 不加载依赖？右键项目根目录 → Reload project，别重启 IDE —— 缓存没刷新，重装也白搭。
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
dlv 调试器报 “no such file or directory” 的真实原因
错误信息是 could not launch process: fork/exec /path/to/dlv: no such file or directory，表面是找不到 dlv，实际卡在三个环节：
- 根本没装：执行
go install github.com/go-delve/delve/cmd/dlv@latest（注意是@latest，不是master） - 装错架构：ARM Mac 上装了 amd64 版本的
dlv，或 Windows WSL 里混用了 Windows 版二进制 - 路径未暴露：
dlv安装后默认在$GOPATH/bin或$HOME/go/bin，但该路径没加进系统PATH，GoLand 就看不到
验证方式：终端直接敲 which dlv，有输出才说明 CLI 可见；GoLand 的调试配置里，dlv path 建议留空（让它自动找），除非你明确要指定某版本。
模块缓存和 GOPATH 的位置偏移容易被忽略
GoLand 默认把模块下载缓存放在 %USERPROFILE%\go\pkg\mod（Windows）或 $HOME/go/pkg/mod（macOS/Linux），随着项目增多，这个目录轻松突破 10GB。C 盘爆满、SSD 性能下降，往往就是它在作祟。
可以迁移，但必须两步一起做：
- 执行
go env -w GOMODCACHE=D:\GoCache\pkg\mod（Windows）或go env -w GOMODCACHE=/Volumes/SSD/GoCache/pkg/mod（macOS） - 在 GoLand 中同步修改：
Settings → Go → GOPATH → Custom path，指向同一父级目录（如D:\GoCache）
只改环境变量不改 IDE 设置，GoLand 仍会往旧路径写索引；只改 IDE 设置不改 GOMODCACHE，go build 命令行仍走老路。两者不同步，缓存就分裂，清理都清不干净。
