需手动在GoLand中配置GOROOT指向Go安装根目录（如/usr/local/go或C:\Go），不可含中文、空格或指向bin子目录；验证方式为新建main.go并确认fmt包可识别跳转。
GoLand 识别不到 go 命令或提示 “No Go SDK found”
这不是 IDE 崩溃，而是它压根没定位到你系统里装的 Go 工具链。GoLand 不读系统环境变量，也不信任 “Auto-detect” —— 尤其在用 asdf、gvm 或自定义路径安装时，几乎必错。
必须手动指定：File → Settings → Go → GOROOT → +，填入真实路径：
- macOS/Linux：
/usr/local/go（Homebrew 安装则可能是/opt/homebrew/opt/go/libexec） - Windows：
C:\Go或你解压的实际路径（如D:\tool\go），注意用正斜杠或双反斜杠
验证方式：新建 main.go，写 fmt.Println("ok")，看是否能跳转进 fmt 包源码。不能？说明 GOROOT 指错了，或者路径含中文、空格、符号（比如 ~/Desktop/我的项目），立刻换掉。
邮箱验证项目依赖标红、go mod download 失败
邮箱验证系统通常依赖 github.com/go-mail/mail、gopkg.in/gomail.v2 或 net/smtp 等包，但 GoLand 默认用内置 SDK 做静态分析，而 module 解析靠的是真实的 go 二进制行为。
常见卡点：
-
go.mod里声明了go 1.21，但GOROOT指向的是go1.19—— 静默失败，不报错但标红 -
Settings → Go → Go Modules里没勾选 “Enable Go modules integration” - 代理不可用：
GOPROXY必须设为国内可用地址，比如https://goproxy.cn，别留空或只写direct
改完后右键项目 → “Reload project”（不是 “Sync”），否则不会触发完整 module 解析。如果仍失败，在终端进项目根目录执行 go mod tidy，再回 IDE 点右上角刷新按钮。
运行或调试时提示 “cannot find package” 或测试按钮灰色
邮箱验证项目常含多个子模块（比如 internal/email、cmd/api），或使用构建标签（如 //go:build smtp）。GoLand 不会自动推断工作目录和构建上下文。
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
关键检查项：
- 运行配置（
Run → Edit Configurations）中 “Working directory” 必须是含go.mod的模块根目录，不是子包路径 - 若用构建标签控制 SMTP 发送逻辑，必须在运行配置的 “Tags” 输入框里填
smtp（空格分隔，不是逗号） - 确保
GO111MODULE=off没被设为环境变量 —— GoLand 不读它，但会干扰终端里go run的行为，造成误判
调试器连不上？检查 Settings → Go → Tools → Go Toolchain 是否与 GOROOT 一致；不一致会导致 dlv 版本不兼容，断点不触发。
gopls 不连接、代码跳转失效、补全卡顿
gopls 是 GoLand 实现语义分析的核心语言服务器，它不是 IDE 自带的，而是由 go install 安装到 GOBIN 目录。如果终端里都找不到 gopls，GoLand 就退化成记事本。
必须执行：
go install golang.org/x/tools/gopls@latest
然后确认：
-
which gopls（macOS/Linux）或where gopls（Windows）输出路径，和go env GOBIN一致 - 该路径已加入系统
PATH，且重启了 GoLand（仅重载项目无效） - IDE 底部状态栏右下角有
gopls连接图标；没图标或显示 “not connected”，说明没生效
邮箱验证项目涉及结构体嵌套、接口实现（如 email.Sender）、泛型工具函数，这些都强依赖 gopls 的类型推导 —— 这步漏掉，后续所有智能提示、重构、跳转都会失灵。
