“no go sdk found”或“invalid sdk”主因是goroot路径错误、目录结构缺失（bin/src/pkg）、zversion.go中theversion常量未匹配，且必须重启ide生效；路径不可含空格/中文/软链，须指向真实根目录如/usr/local/go或c:\go。
GoLand 启动后显示 “No Go SDK found” 或 “The selected directory is not a valid home for Go SDK”，不是 IDE 坏了，而是它根本没加载到你本地装好的 Go —— 手动填错路径、目录结构不全、或版本校验失败，三者占了 95% 的情况。
GOROOT 必须指向真实根目录，且不能含空格/中文
GoLand 不读系统 PATH，也不信 Auto-detect。你必须手动指定 GOROOT 为 Go 安装根目录，例如：
-
/usr/local/go（macOS/Linux 默认） -
C:\Go（Windows MSI 安装） -
/opt/homebrew/opt/go/libexec（macOS Homebrew 安装）
常见错误：
- 填成
/usr/local/go/bin或C:\Go\bin—— 这是命令所在，不是 SDK 根目录 - 路径含中文（如
C:\我的开发\go）或空格（如C:\Program Files\Go）—— 会静默失败 - 用软链接路径（如
~/.asdf/installs/go/1.22.4）—— 必须填实际解压目录（如~/.asdf/installs/go/1.22.4/go）
SDK 目录必须含 bin/src/pkg 且 zversion.go 有 TheVersion
GoLand 启动时硬性校验三项：目录结构、路径层级、版本常量。缺一不可。
检查你填的 GOROOT 下是否同时存在：
-
bin/（含go可执行文件） -
src/（标准库源码，缺失会导致 import 标红） -
pkg/（编译缓存目录）
特别注意 Go 1.17+ 默认不生成 src/runtime/internal/sys/zversion.go，但 GoLand ≤2023.3 仍强制读取它。若该文件不存在或没这行：
const TheVersion = `go1.26.0`
就判定 SDK 非法。解决方法：手动创建或补上这行（TheVersion 值需与你实际 Go 版本一致，用 go version 确认）。
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
图形界面启动导致环境变量未继承
你在终端里 which go 输出正常，但 GoLand 内置终端却找不到 go？大概率是桌面快捷方式启动时没加载 shell 配置。
验证方式：在 GoLand 内置终端执行：
which gogo env GOROOT
输出必须和外部终端完全一致。否则：
- macOS：改用终端启动
open -a GoLand，或把PATH和GOROOT加到~/.zprofile - Linux：修改桌面启动项
Exec=行，加bash -c "source ~/.zshrc && /path/to/goland.sh" - Windows：避免从开始菜单“原生”启动，改用 PowerShell 启动；检查系统级
PATH是否覆盖了用户级设置
配置完不重启，等于没配
点 Apply 后必须**完全退出 GoLand 并重新打开**，GUI 进程不重启，GOROOT 就不会重载 —— Reload project 或 Sync 都无效。
验证是否成功：
- 新建
main.go，写fmt.Println("ok") - import 不红、能 Ctrl+Click 跳转到
fmt源码 - 右上角绿色三角按钮亮起
如果还灰，优先检查 Settings → Go → Go Modules → Enable Go modules integration 是否勾选，以及 GOPROXY 是否设为 https://goproxy.cn,direct —— 缺一不可，否则模块初始化卡住，SDK 绑定也会失败。
