需手动在settings → go → goroot中指定go安装根目录（如/usr/local/go或c:\go），不可含中文、空格或波浪号，且不能选bin子目录；验证方式为新建main.go并确认fmt包可识别及跳转。
GoLand 启动报 “No Go SDK found” 怎么办
这不是 IDE 坏了，是它根本没找到你装的 Go。GoLand 不读 GOROOT 环境变量，也不信 “Auto-detect”，尤其用 asdf 或 gvm 管理多版本时，大概率选错路径。
- 必须手动配置：
File → Settings → Go → GOROOT → +，填真实安装路径，比如/Users/you/.asdf/installs/golang/1.22.5/go（macOS/Linux）或C:\Users\you\.gvm\versions\go1.22.5.windows.amd64（Windows） - 路径里不能有中文、空格、波浪号
~或符号；粘贴比“Browse”更可靠 - 验证方式：新建
main.go，写fmt.Println("ok")，能跳转到fmt源码才算成功
模块代理和环境不一致导致 go mod init / go get 卡死
错误现象常是 cannot find module providing package、超时、或 go.mod 生成但依赖没拉下来——问题不在 IDE，而在 CLI 和 GoLand 用的环境不统一。
GoLand 2026.1.1
下载
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 终端执行
go env -w GOPROXY=https://goproxy.cn,direct（国内）或go env -w GOPROXY=https://proxy.golang.org,direct（海外），不是只在 GoLand 设置里填 -
go env GO111MODULE必须输出on；若为auto或空，立刻执行go env -w GO111MODULE=on - 新建项目路径必须是干净英文目录，且不能在
$GOPATH/src下（旧 GOPATH 残留易冲突） - 已有
go.mod但 GoLand 没反应？右键项目根目录 →Reload project，别重启 IDE
dlv 调试器启动失败：“could not launch process: fork/exec … no such file or directory”
表面是找不到 dlv，实际是三个环节断了：没装、装错版本、或路径没暴露给 IDE。
- 终端运行
dlv version；无输出？说明没装，执行go install github.com/go-delve/delve/cmd/dlv@latest - Go 1.21+ 必须配 dlv 1.21+；用旧版（如 1.20.x）会静默崩溃，别图省事复用
-
which dlv必须返回路径（如/Users/you/go/bin/dlv）；若为空，检查go env GOBIN，把该路径加进 shell 的PATH - GoLand 中调试配置的
dlv path必须指向这个二进制，别用默认值
gopls 卡住、跳转失效、LSP 报错
gopls 行为完全取决于终端里 go env 的输出，不是插件设置页里填的值。常见原因是环境没继承、workspace 不对、或依赖图异常。
- 确保
~/.zshrc（或~/.bashrc）里已设export GOPROXY=https://goproxy.cn,direct，然后source ~/.zshrc，再彻底重启 VS Code 或 GoLand（不是重载窗口） -
.vscode/settings.json或 GoLand 的Settings → Languages & Frameworks → Go → Go Tools中，只保留最小配置："go.formatTool": "goimports"，其余交给 gopls 自动推导 - 确认 workspace folder 是项目根目录（含
go.mod），不是~/go/src/xxx这类旧路径 - 卡住时先跑
go mod graph | head -20查循环依赖；再执行go list -m all看是否所有模块都可解析
dlv 版本兼容性。这些点一旦漏掉，就会在调试、跳转、格式化等高频操作上反复卡住，而且错误信息和真实原因往往不匹配。
