GoLand 标红但代码能运行，是其符号索引损坏所致，需执行 Invalidate Caches and Restart 并确保 go.mod 位置正确、GOROOT 配置无误、GO111MODULE 开启。
GoLand 标红但代码能跑，大概率是符号索引坏了
这不是 Go 编译器的问题，而是 GoLand 自己维护的符号数据库（用于跳转定义、Find Usages、结构体补全）没跟上源码变化。常见于刚 clone 项目、改了包名/结构体名、移动文件、或 go.mod 路径解析异常后。此时 go build 和 go run 完全正常，但 IDE 里满屏标红、Ctrl+Click 失效、自动补全漏字段。
必须用 Invalidate Caches，go clean 不管用
go clean -cache 清的是 Go 编译中间产物（.a 文件），go clean -modcache 清的是模块源码，两者都**不碰 GoLand 的符号索引**。IDE 的索引是独立存储在本地配置目录里的，和 Go 工具链缓存完全隔离。
- 点击顶部菜单 File → Invalidate Caches and Restart…
- 勾选 Invalidate and Restart（不要只选 “Just Restart”）
- 等重启后左下角出现 Indexing…，直到该提示消失才算完成
- 首次索引可能耗时几十秒到几分钟，取决于项目大小和磁盘速度
为什么有时候清完还是标红？检查这三处
索引重建失败往往不是缓存没清干净，而是 IDE 没正确识别项目上下文：
GoLand 2026.1.1
下载
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
-
go.mod文件是否在项目根目录？GoLand 默认只把含go.mod的目录当模块根；如果它在子目录（如backend/go.mod），需右键该目录 → Mark Directory as → Sources Root - Go SDK 是否已正确绑定？Settings → Go → GOROOT 必须指向真实 Go 安装路径，不能是空或错误路径
- 是否启用了
GO111MODULE=off？检查 Settings → Go → Build Tags & Vendoring 里 “Go modules integration” 是否开启；关闭会导致 IDE 退化为 GOPATH 模式，无法解析现代模块路径
索引卡住不动或反复重建？关掉自动构建再试
GoLand 默认开启 Build project automatically，每次保存都会触发后台 go list 分析，可能和索引重建抢资源，导致卡死或状态错乱：
- 进 Settings → Go → Build Tags & Vendoring，取消勾选 Build project automatically
- 再执行一次 Invalidate Caches and Restart…
- 等索引完成后再手动开回来（可选）
真正要命的不是缓存多大，而是索引错位——它会让 IDE 认为你引用了一个根本不存在的符号，哪怕那个结构体就定义在同个包的隔壁文件里。清缓存只是重置起点，后续能否建对，全看 go.mod 位置、SDK 配置、模块模式开关这三件事有没有踩准。
