goland 2026.2 + go 1.26 组合需严格规避中文/空格路径（如d:\soft\go），安装后须验证go version与go env goroot一致，首次启动前清空%localappdata%\jetbrains\goland2026.2目录，并手动触发语法迁移扫描以支持errors.astype等新特性。
GoLand 2026.2 + Go 1.26 是当前最稳定、兼容性最强的组合，但直接装完就写代码，90% 的人会在 go run 报错、errors.AsType 不识别、或调试器卡在 runtime.mstart 里出不来——根本原因不是版本不匹配，而是 IDE 启动时没加载对的 Go 运行时上下文。
Go SDK 安装必须避开中文路径和空格
哪怕你只在路径里加了一个“（2026）”，go env GOROOT 能正常输出，GoLand 仍会在启动时静默跳过该 SDK。这不是 Bug，是 Go 工具链底层用 CreateProcessW 启动子进程时对宽字符路径的处理缺陷。
- 推荐安装路径：
D:\Soft\Go（纯英文、无空格、非系统盘） - 安装后立刻验证：
go version和go env GOROOT必须指向同一路径 - 如果已装在
C:\Program Files\Go，不要改环境变量去“绕过”，直接重装——旧路径残留会污染GOBIN和build cache
GoLand 首次启动必须手动清空配置缓存
2026.x 系列启动时会读取 %LOCALAPPDATA%\JetBrains\GoLand2026.2\cache 下的索引快照。如果之前装过 2025.x 或试用过 EAP 版本，这个目录里的 index.bin 和 project.model 会强制沿用旧版解析规则，导致 Go 1.26 的新语法（如 type alias、errors.AsType）被标记为错误。
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 关闭 GoLand 后，手动删除整个
%LOCALAPPDATA%\JetBrains\GoLand2026.2目录（不是只删 cache 子目录） - 重启时选择
Do not import settings，不要点“从旧版本导入” - 首次打开 Settings → Go → GOROOT 前，先确认右下角状态栏显示 “Go SDK: 1.26.x” —— 如果显示 “1.23.x” 或空白，说明它偷偷加载了旧缓存
go.mod 里声明 go 1.26 后必须触发语法迁移扫描
GoLand 不会自动全量扫描项目更新语法，它只在你主动触发时才运行 go fix 的 IDE 封装逻辑。如果你只改了 go.mod 却没点那个按钮，编辑器里 err.(*os.PathError) 还是黄色波浪线，errors.AsType 也不会补全。
- 打开
go.mod文件，光标停在go 1.26行，等 2 秒出现灯泡图标 → 点击Analyze code for syntax updates - 或者按双 Shift，输入
Update Syntax，选中 “Entire project” - 关键动作：在 Problems 工具窗口里勾选所有建议项，右键 →
Apply selected fixes，别只点单个文件的快速修复
调试器连不上 runtime.mstart？检查是否启用了 Runtime Mirror
2026.1.1 起默认启用 Runtime Mirror 调试模式，它会把 runtime 包符号映射到本地源码，但前提是你的 GOROOT/src/runtime 目录完整且未被 git clean 删除。很多用户用 go install 更新 Go 后，src 目录只剩 stub 文件，镜像失败就卡在 mstart。
- 验证命令：
ls -la $(go env GOROOT)/src/runtime/asm_amd64.s，必须存在且非空 - 如果缺失，重新下载对应 Go 1.26.x 的 .msi 安装包，运行修复（Repair）而非重装
- 临时禁用镜像：Settings → Go → Debugger → 取消勾选
Enable runtime source mapping，但会丢失runtime.gopark等底层调用栈追踪能力
最易被忽略的是：GoLand 的 go fix 扫描依赖 go list -deps -f '{{.ImportPath}}' ./... 的输出结果，如果你项目里有 //go:build ignore 的测试文件或 vendor 中混入了 Go 1.22 的包，扫描会跳过整个子模块——得先在终端跑一遍 go list -e -f '{{.Dir}}' ./... 看哪些路径被排除了，再针对性清理。
