GoLand没有“本地架构缓存”，需清理的是Go工具链的$GOCACHE（用go clean -cache）和$GOMODCACHE（用go clean -modcache），以及GoLand自身索引（通过Invalidate Caches and Restart）。
GoLand 没有“本地架构缓存”这个概念，它不维护独立的“架构级”缓存；你实际想清理的，是 Go 工具链生成的构建产物、模块依赖和 IDE 自身索引——混在一起就容易误操作。
go clean -cache 清的是 $GOCACHE，不是 GoLand 的“架构缓存”
GoLand 本身不存所谓的“架构缓存”，它依赖 go build、go test 和 gopls（Go 语言服务器）工作。其中真正影响构建行为和代码感知的，是 Go 自己的缓存：
-
$GOCACHE（默认 macOS 在~/Library/Caches/go-build）：存编译中间产物（.a文件），go clean -cache清的就是它 -
$GOMODCACHE（默认$GOPATH/pkg/mod）：存下载的模块源码和校验数据，go clean -modcache清这里 - GoLand 的索引文件（如
.idea/misc.xml或index/目录）属于 IDE 内部状态，和 Go 构建逻辑无关
常见错误现象：go run 没生效、go test 返回 cached、切换 CGO_ENABLED 后链接失败——这些全是 $GOCACHE 混杂了不同构建模式产物导致的，不是 GoLand 的锅。
实操建议：
- 运行
go clean -cache即可清空构建中间产物，无需进项目目录，全局生效 - 确认路径：
go env GOCACHE，别误删父目录（比如删成rm -rf $(go env GOCACHE)而不是rm -rf $(go env GOCACHE)/*） - 如果设了
GOCACHE=off，该命令什么也不做 - 清理后首次
go build变慢是正常现象，缓存重建需要时间
框架适配问题（如 Gin/GRPC）本质是模块缓存或构建模式不一致
所谓“框架适配失效”，比如改了路由没反应、gRPC 生成代码不更新、go list -m all 显示版本和 go.mod 对不上——根本原因几乎都在模块缓存或构建参数冲突上，和 GoLand 界面设置关系极小。
常见错误现象：
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
cannot find module providing package github.com/gin-gonic/gin-
checksum mismatch报错但go.sum没变 - 切换私有
GOPROXY后，旧模块仍被复用
实操建议：
- 先确认
GO111MODULE=on，否则go clean -modcache静默无效 - 不要用
go clean -modcache日常清理——它会删掉整个$GOMODCACHE，下次构建要重下所有依赖 - 只想重拉某个框架？手动删对应目录：
rm -rf $(go env GOMODCACHE)/github.com/gin-gonic/gin@v1.9.1 - 删完立刻跑
go mod download github.com/gin-gonic/gin@v1.9.1，再执行go mod verify校验一致性
GoLand 自身索引和语义分析缓存怎么处理
GoLand 的“卡顿”“跳转错乱”“提示缺失”，往往不是缓存问题，而是 gopls 配置不当或项目结构识别异常。它没有单独的“架构缓存开关”，但有几处关键设置能减少干扰：
- 关闭 Settings → Go → Build Tags & Vendoring → Build project automatically（避免每次保存都触发构建，往
$GOCACHE写垃圾） - 检查 Settings → Go → Language Server → build.ignore，填入
bin/,pkg/,vendor/，防止gopls对构建产物做语义分析 - 必要时手动清除 IDE 索引：File → Invalidate Caches and Restart → Invalidate and Restart（这清的是 GoLand 自身索引，不影响
$GOCACHE或$GOMODCACHE）
注意：Invalidate Caches 不等于清理 Go 缓存，它只重置 IDE 的符号表和跳转缓存；如果你没改过代码却看到奇怪的红色波浪线，优先怀疑 gopls 是否卡住，而不是去删 $GOPATH/pkg/mod。
最容易被忽略的一点：go clean -i 只清理当前目录 main 包安装的二进制，它不会跨 cmd/ 子目录生效；而 GoLand 的 Run Configuration 如果指向了旧 go install 产物，清理缓存也救不了——得删 $GOBIN 下对应文件，或直接改 Run Config 的 executable path。
