goland 无法识别 go sdk 的根本原因是未正确读取 goroot 下 src/runtime/internal/sys/zversion.go 中的 const theversion = gox.y.z，需手动补全并彻底重启 ide。
GoLand 里找不到 Go SDK 选项，显示 “no version”
根本原因是 GoLand 读不到 GOROOT 下的版本标识，尤其在手动解压 zip 版本（非 .msi 安装包）后常见。它依赖 src/runtime/internal/sys/zversion.go 文件里的 TheVersion 常量来识别 SDK 版本号。
常见错误现象：Project Structure → SDKs 页面空着、只有 “Add SDK” 按钮，点开后看不到任何 Go 版本，或提示 “Unpacked SDK is corrupted”。
- 打开你当前
GOROOT目录下的src\runtime\internal\sys\zversion.go（Windows）或src/runtime/internal/sys/zversion.go（macOS/Linux） - 确认文件中是否存在
const TheVersion = `goX.Y.Z`这一行；若缺失或写错（比如拼成theVersion小写），就加一行，值必须和你解压的版本完全一致（如go1.23.10） - 保存文件，**重启 GoLand**（不是重载项目，是彻底关闭再启动）
- 再次进入 Project Structure → SDKs，点击 Add SDK → Local，就能看到该路径被识别为有效 Go SDK
切换项目级 Go SDK，而不是全局改环境变量
不同项目可能依赖不同 Go 版本（比如老项目锁死在 go1.18.10，新项目用 go1.25.8），硬改系统 GOROOT 会导致其他项目出问题。GoLand 支持 per-project 独立指定 SDK。
GoLand 2026.1.1
下载
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 打开目标项目 → File → Project Structure → Project
- 在 Project SDK 下拉框中，选 “New… → Go SDK → Local”
- 浏览到你存放 Go 版本的目录（如
D:\GoVersions\go1.18.10\go或~/sdk/go1.25.8），选中后确定 - 确保勾选了 “Inherit project SDK” 的模块也同步更新（或单独进 Modules 设置确认）
- 不要依赖 “Download” 按钮——它只下载最新稳定版，无法选旧版本
为什么改了系统 GOROOT，GoLand 还不认新版本？
因为 GoLand 启动时只读一次系统环境变量，之后不会动态刷新。而且它缓存了 SDK 列表，即使你改了 GOROOT 并重启终端，IDE 本身仍可能沿用旧缓存。
- 改完系统
GOROOT和PATH后，必须**完全退出 GoLand 再重新启动**（Mac 上注意 Dock 图标右键“退出”，不是关窗口） - 如果用了批处理脚本（如
switch-go1.22.bat）只改当前 cmd 窗口变量，那从桌面图标或开始菜单启动的 GoLand **根本看不到这些变量** - 验证是否生效：启动 GoLand 后，打开 Terminal（Alt+F12），运行
go version和echo %GOROOT%（Windows）或echo $GOROOT（macOS/Linux），结果必须和你预期一致 - IDE 自带 Terminal 默认继承系统环境变量，但如果你配置了自定义 Shell 启动命令（如
pwsh -noexit），需确认该 Shell 是否加载了更新后的环境
gvm / govm 工具和 GoLand 能不能配合用？
可以，但要注意路径映射关系。gvm 默认把每个版本装在 ~/.gvm/gos/goX.Y.Z，而 GoLand 需要的是这个完整路径，不是 gvm 的 wrapper 脚本位置。
- 用
gvm list查看已安装版本，比如输出go1.21.6 - 它的真实路径通常是
~/.gvm/gos/go1.21.6（Linux/macOS）或%USERPROFILE%\.gvm\gos\go1.21.6（Windows） - 在 GoLand 的 Add SDK → Local 中，就填这个完整路径，**不要填
~/.gvm/bin/go或类似 wrapper 路径** - Windows 用户注意：
%USERPROFILE%在 GoLand 文件选择器里不能自动展开，得手动替换成C:\Users\YourName - 一旦设好，GoLand 就和 gvm 解耦了——你用
gvm use切换终端版本，不影响 IDE 当前项目的 SDK 绑定
zversion.go 后没重启 GoLand，或者改了系统变量却忘了检查 IDE 内置 Terminal 的 go version 输出。IDE 不会主动 reload 环境，一切以它启动那一刻的变量快照为准。
