GoLand提示“Go SDK not configured”是因未手动指定GOROOT路径，需在Project Structure中添加真实Go版本路径（如~/.goenv/versions/1.22.0），而非默认安装路径。
GoLand 启动后提示“Go SDK not configured”
这是最常见拦路虎，不是没装 Go，而是 GoLand 没找到 GOROOT 或没识别已安装的 Go 版本。GoLand 不会自动扫描系统 PATH 里的 go 命令，必须手动指定 SDK 路径。
- 确认已通过官方安装包或
brew install go（macOS）/choco install golang（Windows）安装 Go，运行go version能正常输出 - 在 GoLand 中打开 File → Project Structure → Project → Project SDK，点击
Add SDK → Go SDK - 不要选
/usr/local/go（macOS）或C:\Program Files\Go（Windows）这种默认路径——很多用户装的是多版本 Go（如用goenv或asdf），真实路径是类似~/.goenv/versions/1.22.0或~/.asdf/installs/golang/1.22.0/go - 选中对应版本的
bin目录上级路径（即包含src、pkg的那个目录），GoLand 会自动校验并加载
新建项目时模块初始化失败：go mod init 报错或不生效
GoLand 默认在新建项目时勾选 “Initialize go module”，但若当前目录已有 go.mod、或父目录存在 go.mod、或 GOPROXY 配置异常，就会静默失败，界面无提示，go.mod 文件也不生成。
- 新建项目前，先终端执行
go env -w GOPROXY=https://proxy.golang.org,direct（国内建议换为https://goproxy.cn） - 确保项目根目录**完全干净**：没有
go.mod、没有vendor、不处于 Git 子模块内 - 如果新建后没生成
go.mod，别急着删项目——直接在 GoLand 终端里手动运行go mod init example.com/myapp，然后右键项目 → Reload project - 注意：模块名不能以
.或..开头，也不能是纯数字；若用本地路径（如./mylib），GoLand 可能无法正确解析依赖
代码补全失效、跳转到定义报 “Cannot find declaration”
不是插件问题，大概率是 GoLand 的索引没建好，或 GO111MODULE 环境变量与项目实际模式冲突。
GoLand 2026.1.1
下载
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 检查右下角状态栏是否显示
Go Modules（而非GOPATH）——若显示后者，说明 GoLand 认为你在 GOPATH 模式下开发，会忽略go.mod - 打开 Settings → Go → Go Modules，确认
Enable Go modules integration已勾选，且Vendor directory路径为空（除非你真用了go mod vendor） - 执行 File → Invalidate Caches and Restart → Just Restart，重启后等待右下角出现 “Indexing…” 进度条走完（通常需 10–60 秒）
- 若仍无效，在终端进项目根目录运行
go list ./...，看是否报错——比如因replace指向不存在的本地路径，会导致 GoLand 解析失败
调试时断点不命中，或提示 “Delve binary not found”
GoLand 调试依赖 Delve（dlv），但它不会自动下载或更新，尤其升级 Go 版本后容易脱节。
- 首次调试前，GoLand 会弹窗问是否下载 dlv，**务必点 “Download”**；若错过，手动去 Settings → Go → Debugger → Delve，点击
Download - 不要用
go install github.com/go-delve/delve/cmd/dlv@latest全局安装——GoLand 默认使用自带 dlv，且不同 Go 版本需要匹配的 dlv 版本（如 Go 1.22 需 dlv v1.23+） - 检查
dlv是否被其他工具（如 VS Code）修改过权限：运行ls -l $(which dlv)，确保有可执行权限；macOS 上若提示 “damaged” 或 “cannot be opened”，需执行xattr -d com.apple.quarantine $(which dlv) - 调试配置里，
Run kind选Package还是File很关键：选File时只调试单个.go文件，不加载模块依赖，容易找不到符号
真正卡住的往往不是装不装得上，而是 GoLand 和 Go 工具链之间那几处隐性契约——比如它信任你设对了 GOROOT，但不告诉你哪里错了；它默默按 GO111MODULE 决定用不用模块，却不在 UI 显式标出当前模式。盯住状态栏、重试索引、亲手敲一遍 go mod 命令，比反复点“重新配置 SDK”有用得多。
