GoLand模块导入失败主因是gopls未读取正确go.mod上下文或项目未识别为模块，需先确认go.mod存在且GO111MODULE=on，再重载项目、启用Go Modules集成，并统一IDE与终端的GOPROXY等环境变量。
GoLand 里模块导入失败，先别急着删整个 pkg/mod
GoLand 报“cannot find package”或“import path not resolved”，90% 不是缓存坏了，而是 gopls（Go 语言服务器）没读到正确的 go.mod 上下文，或者项目未被识别为 Go 模块。直接运行 go clean -modcache 往往白忙——它清的是下载缓存，不是 IDE 的索引或语言服务器状态。
- 先确认项目根目录有
go.mod，且GO111MODULE=on（运行go env GO111MODULE查看） - 在 GoLand 中右键项目 → Reload project（不是 “Rebuild”），强制 gopls 重新加载模块图
- 检查 Settings → Go → Go Modules → Enable Go modules integration 是否勾选；若用 vendor，还要勾选 Vendoring mode
- 如果刚切换分支或改过
go.mod，关掉 GoLand，删掉项目根目录下的.idea/go.xml和.idea/misc.xml（保留其他配置），再重开
真正要清的缓存：gopls 索引 + $GOCACHE，不是 $GOMODCACHE
GoLand 依赖 gopls 提供跳转、补全和错误提示，而 gopls 自己会缓存解析结果；同时 go build 生成的中间文件（.a）也会影响类型推导。这两类缓存才常导致“明明有包却报错”。
GoLand 2026.1.1
下载
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 清理 gopls 缓存：
gopls cache delete（需先go install golang.org/x/tools/gopls@latest） - 清理构建缓存：
go clean -cache（删$GOCACHE，不影响模块下载） - 不推荐
go clean -modcache：它删的是$GOMODCACHE（默认$GOPATH/pkg/mod），清完后首次go build会卡在 downloading，容易误判为“IDE 还是不行” - Windows 用户注意：
go clean -cache在 PowerShell 里可能因路径空格失败，换 CMD 或加引号：go clean "-cache"
手动删 pkg/mod 目录是高危操作，除非你明确知道后果
有人看到 $GOPATH/pkg/mod 占几十 GB，顺手 rm -rf，结果 GoLand 反复弹出 “Fetching dependencies…” 卡住半天，甚至 go list -m all 输出一堆 missing。这不是缓存“失效”，是本地货仓真没了，而 IDE 还在等它就绪。
- 删前先运行：
du -sh $(go env GOMODCACHE)，如果不到 2GB，基本不用动 - 删后必须立刻跑：
go mod download（不加参数），否则 GoLand 后台go list会无限等待 - 若项目用了
replace或本地路径依赖（如require ./internal/utils），手动删pkg/mod会破坏符号链接，导致go build拉错远程版本 - CI 或多项目共享 GOPATH 时，删
pkg/mod会让其他项目也变慢——它们得各自重下一遍
最常被忽略的一点：GoLand 的代理设置和终端不一致
你在终端设了 export GOPROXY=https://goproxy.cn，但 GoLand 启动时没继承这个环境变量，结果 gopls 走默认 proxy.golang.org，国内超时失败，报 “no matching versions for query” —— 看起来像缓存问题，其实是网络策略没对齐。
- 进 GoLand Settings → Go → Environment，点击 Override environment variables，填入
GOPROXY=https://goproxy.cn - 同时检查
GOSUMDB：若公司用私有 sumdb，这里也要同步设置，否则go mod verify失败，gopls 就不敢信任模块 - 改完重启 GoLand，不要只 reload project —— 环境变量是进程级的，reload 不生效
- 验证是否生效：打开 Terminal 面板，在 GoLand 内置终端里运行
go env GOPROXY，输出应和你设的一致
