GoLand不支持单项目内模块级多版本共存，因Go工具链强制要求整个工作区统一Go版本；正确做法是用Multi-root Workspace配合每个模块根目录下的.tool-versions文件及asdf插件实现项目级版本隔离。
GoLand 无法为不同模块分配不同 Go 版本
GoLand 本身不支持「一个项目里让 module A 用 Go 1.20、module B 用 Go 1.22」——这不是 IDE 功能缺失，而是 Go 工具链根本禁止这种混合编译。Go 的 go build 和 gopls 都以当前 shell 环境中的 go 命令为准，而该命令只能指向一个 GOROOT。你看到的“模块级版本切换”实际是项目级上下文切换，不是并发共存。
正确做法：用 Multi-root Workspace + 每个根目录配独立 .tool-versions
当你有多个子模块（如 ./auth、./payment、./shared），且它们分别要求 Go 1.20 和 Go 1.22 时，必须把它们作为独立根目录加入 GoLand 的 Multi-root Workspace，并确保每个根目录下都有自己的 .tool-versions 文件：
-
.tool-versions必须放在每个模块的根目录（即含go.mod的目录），内容仅一行：golang 1.20.14或golang 1.22.3 - GoLand 必须安装并启用
asdf Shell Integration插件，否则它读不到.tool-versions，仍会 fallback 到系统默认 Go - 每个根目录右键 →
Go Tools→Configure Go Tools→ 勾选Use GOPATH and GOROOT from environment，禁用手动指定GOROOT - 打开 Terminal 面板后，执行
asdf current golang应显示当前所处根目录对应的版本；若不一致，重启 GoLand 或重载项目
常见错误：在 go.work 中混用不兼容 Go 版本
go.work 是协作开发的必需机制，但它不解决版本冲突——它只统一模块发现路径。如果你在 go.work 中同时 use ./auth（要求 Go 1.22）和 use ./legacy（go.mod 写着 go 1.19），那么只要你在根目录执行 go build，就会立刻报错：go: cannot use go 1.19.15 with go 1.22 module。这不是 GoLand 的问题，是 Go 工具链的硬校验。
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 验证方式：在终端 cd 进某个模块根目录，运行
go version和head -n1 go.mod，二者必须满足 ≥ 关系 - CI 构建时务必加
-modfile=go.mod，避免go.work干扰生产构建 - 不要试图用
replace或exclude绕过版本检查——它们不改变go.mod声明的最低语言版本要求
最易被忽略的细节：IDE 缓存与窗口生命周期
GoLand 对 Go 版本的感知是“窗口级”的，不是“项目级”。你改完 .tool-versions 后，如果只是刷新项目或重启服务，gopls 仍可能卡在旧版本。必须：
- 关闭当前 GoLand 窗口（不是退出软件，是关掉整个窗口）
- 重新通过文件系统路径打开 Multi-root Workspace（不能从最近项目列表点开）
- 打开 Terminal 后先执行
asdf reshim golang，再验证go version - 检查
Help → Diagnostic Tools → Debug Log Settings中是否有gopls启动失败日志，常见原因是GOROOT路径含空格或中文
跨模块引用只靠 go.work 生效，别碰 replace，也别手写 ../shared —— 那会让 gopls 跳转失效，且 go build 直接拒绝编译。
