GoLand 误报“undefined”或“cannot find package”时，应先执行 go clean -cache 清理 $GOCACHE，因 gopls 依赖其中缓存做符号分析，旧缓存会导致 IDE 标红而实际编译通过；清理后等待 gopls 自动重建索引。
GoLand 误报“undefined”或“cannot find package”时，先清 $GOCACHE
GoLand 本身不维护独立的语义缓存，它依赖 gopls（Go 语言服务器）读取 $GOCACHE 中的编译产物做符号分析。一旦 $GOCACHE 里残留了旧版编译结果（比如改了函数签名但缓存没更新），gopls 就会把未重建的 .a 文件当真，导致 IDE 里标红“undefined”，而 go build 却能过。
-
go clean -cache是最直接解法，它删掉$GOCACHE下所有中间文件（.a、.o等），不碰源码和模块缓存 - 执行前确认路径：
go env GOCACHE（macOS 默认是~/Library/Caches/go-build） - 别用
rm -rf $GOCACHE替代——go clean -cache会跳过正在被进程占用的条目，更安全；手动强删可能让gopls崩溃或卡住 - 清理后首次打开项目或保存文件，
gopls会自动触发重建，IDE 右下角可能显示 “Indexing…”，等它完成再看报错是否消失
GoLand 报 “checksum mismatch” 或模块版本错乱，必须清 $GOMODCACHE
这类报错不是 IDE 的锅，而是 gopls 从 $GOMODCACHE（默认 $GOPATH/pkg/mod）读到了损坏或过期的模块数据。比如你本地改过某个依赖的源码但没 go mod edit -replace，又或者私有代理返回了不一致的 zip 包，gopls 就会拿缓存里的 .info 和 go.sum 对不上号，直接标红整个 import 行。
GoLand 2026.1.1
下载
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 运行
go clean -modcache，它会清空整个模块缓存目录，包括cache/download/下的.zip和校验文件 - 执行前确保
GO111MODULE=on，否则命令静默失败 - 清完立刻跑
go mod verify，确认go.sum和新下载的模块一致；如果失败，说明go.sum本身已脏，得配合go mod tidy - 别手动删
$GOPATH/pkg/mod子目录——软链接（如-replace创建的）会被破坏，下次go build可能拉错远程版本
GoLand 调试器报 “Delve version too old”，本质是二进制缓存没刷新
GoLand 自带 Delve 二进制（dlv.exe 或 dlv），它和你终端里 go install 的不是同一个。IDE 启动调试时根本不会查 $GOBIN，而是硬编码读取插件目录下的 dlv。所以即使你终端里 dlv version 显示最新，IDE 仍可能用旧版报错。
- 先关掉 GoLand，再用
go install github.com/go-delve/delve/cmd/dlv@latest装新版 - 找到 GoLand 插件目录里的
dlv（Windows：类似C:\Users\XXX\AppData\Local\JetBrains\GoLand2026.1\plugins\go-plugin\lib\dlv\） - 用新装的
dlv覆盖插件目录下所有同名文件（包括windows/和windowsarm/子目录） - 顺手清 GoLand 自身缓存：
Remove-Item -Recurse -Force "$env:LOCALAPPDATA\JetBrains\GoLand2026.1\cache"（PowerShell）或对应 macOS/Linux 路径
为什么清理后 IDE 还卡在 “Loading packages…”
这不是缓存没清干净，而是 gopls 正在重建索引——尤其当你刚清了 $GOCACHE 或 $GOMODCACHE，它得重新解析所有依赖的 AST。这个过程可能持续几十秒到几分钟，取决于模块数量和磁盘速度。此时强行重启 IDE 或禁用 gopls 只会让问题更糟。
- 观察 GoLand 右下角状态栏，如果显示 “Indexing…” 或 “Loading packages…”，就等它完成
- 不要在
Settings → Go → Language Server里关掉gopls——那是治标不治本，且会丢掉跳转、补全等核心功能 - 若长时间不动，检查
gopls日志：Help → Show Log in Explorer，搜索gopls关键字，看是否有context deadline exceeded（说明磁盘 I/O 或网络慢） - 真正容易被忽略的是：GoLand 的 “Build project automatically” 会高频触发
gopls分析。如果你不用它，关掉Settings → Go → Build Tags & Vendoring → Build project automatically，能显著减少误触发
