go clean -modcache会清空整个$GOPATH/pkg/mod目录，不区分Go版本，是官方推荐的模块缓存清理方式，不影响$GOCACHE。
go clean -modcache 会清掉所有 Go 版本共用的模块缓存
Go 的模块缓存 $GOPATH/pkg/mod 是全局共享的，和当前 go 命令版本无关。无论你用 go1.20 还是 go1.22 执行 go mod download，下载的模块都写进同一个 $GOPATH/pkg/mod 目录。所以切换 Go 版本本身不会“产生”新缓存，但可能因 go.mod 中 go 1.x 指令或构建约束触发不同依赖解析逻辑，导致某些模块被重复拉取或残留旧版本。
执行以下命令即可彻底清空：
go clean -modcache
它会删掉整个 $GOPATH/pkg/mod，不区分 Go 版本。之后首次 go mod tidy 会重新下载所有依赖，耗时略长但干净。
- 别手动
rm -rf $GOPATH/pkg/mod—— 虽然效果一样，但go clean -modcache是官方支持方式，能避免误删$GOPATH/pkg下其他内容（比如bin/） - 如果你设置了自定义
GOPATH，先确认go env GOPATH输出是否是你预期的路径，否则go clean -modcache可能清错地方 -
go clean -modcache不影响$GOCACHE（构建对象缓存），那是另一类东西，需单独用go clean -cache
GoLand 里多 GOPATH 配置会干扰依赖识别，不是缓存问题而是路径冲突
你切 Go 版本时如果顺手改了 GOPATH 环境变量，或者在 GoLand 的 Settings → Go → GOPATH 里填了多个路径（如 /Users/x/gopath1:/Users/x/gopath2），IDE 就可能从不同 GOPATH 下加载重复或冲突的包，表现为 import 标红、go list 报错、甚至 Build constraints exclude all the go files。
检查并清理步骤：
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 终端运行
go env GOPATH，只保留一个有效路径；若为空，说明走默认~/go，那就别在 GoLand 里额外填 GOPATH - GoLand 中打开 Settings → Go → GOPATH，清空该字段（留空即可），让 IDE 完全跟随
go env结果 - 关闭 Settings → Go → Build Tags & Vendoring → “Use GOPATH to resolve dependencies”，这个选项在 Modules 项目中应禁用
- 右键项目根目录 → Synchronize，强制刷新模块索引
GoLand 自身缓存可能记住旧 Go 版本的模块解析结果
即使你已切换 Go SDK 并清了 modcache，GoLand 还可能在 ~/Library/Caches/JetBrains/GoLand*/ 下缓存旧的模块结构、符号表或 gopls 状态，导致补全仍指向旧版本依赖、跳转失效或标红不消失。
必须连带清理：
- 执行
File → Invalidate Caches and Restart → Invalidate and Restart - 或者手动删缓存目录：
rm -rf ~/Library/Caches/JetBrains/GoLand*
（macOS） - 重启后，GoLand 会用当前
go命令重新跑go list -modfile=go.mod -deps -json all构建模块图，这才是真正“重置”依赖视图
为什么 go mod tidy 后仍有标红？检查 gopls 是否用了错误的 go binary
GoLand 底层靠 gopls 提供语义分析，而 gopls 启动时会读取环境变量或显式指定的 go 路径。如果你用 Toolbox 切换 Go 版本，但 gopls 仍绑着旧版 go，就会解析失败。
验证与修复：
- 打开 Settings → Go → Language Server → “Path to Go binary”，确认这里指向你当前想用的
go（例如/usr/local/go-1.22/bin/go），而不是/usr/local/go/bin/go这种可能软链接错位的路径 - 终端执行
which go和 GoLand 中显示的路径比对，不一致就手动填准 - 改完后点 “Restart Server”，别只点 “Apply”
- 留意底部状态栏：如果显示
gopls (v0.15.2, go1.20)却你正用 1.22，说明没生效
多版本切换真正的麻烦不在缓存体积，而在路径、环境变量、IDE 配置三者没对齐——哪怕只差一个斜杠或软链接没更新，gopls 就可能静默降级到 fallback 行为，标红却报不出具体错。
