GoLand标红但go build能过，是符号索引缓存失效导致的假报错；需依次执行go mod tidy、Reload project from disk，再File → Invalidate Caches and Restart重建索引。
GoLand符号标红但go build能过，是索引坏了
这不是代码写错了，是GoLand内部维护的符号引用关系断了。比如结构体Options明明在api/type.go里定义了，跳转Ctrl+B失效、补全不出现、甚至整个包名都标红——但终端里go run main.go完全没问题。本质是IDE没正确解析go.mod路径、文件刚移动过、或索引中途卡住没更新。
Invalidate Caches and Restart是最直接有效的清理方式
别试“重启IDE”这种软重启，必须清缓存再重建索引。操作路径是：File → Invalidate Caches and Restart… → Invalidate and Restart。注意三点：
- 点击后IDE会强制删除所有本地索引、符号缓存、插件状态，不是简单刷新
- 重启后左下角会出现
Indexing进度条，等它消失（通常几秒到一两分钟）再开始编码 - 如果项目含大量第三方模块，首次索引可能触发
go list -mod=readonly扫描，此时终端偶尔弹出go: downloading日志属正常
索引仍异常？用Repair IDE → Rescan Project Indexes
缓存清了但跳转还是失败，说明项目级索引没重建干净。这时别再重复Invalidate Caches，改走修复流程：
GoLand 2026.1.1
下载
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 菜单栏点
File → Cache Recovery → Repair IDE - 等第一阶段自动完成（刷新虚拟文件系统），点击
Rescan Project Indexes - 这步会重新扫描所有
.go文件，识别package声明、导入路径、结构体定义位置，并重建跨文件引用链 - 若
Rescan后仍有问题，再点Drop Indexes For All Projects and Reindex Current Project——这是终极重索引，耗时稍长但覆盖最全
别漏掉go mod tidy和Reload project from disk
索引依赖准确的模块元数据。常见坑是go.mod里版本号手动改过、或新增依赖后没同步：
- 终端进项目根目录，执行
go mod tidy，确保go.sum和依赖树一致 - 回到GoLand，右键项目根目录 →
Go → Reload project from disk，强制让IDE读取最新go.mod内容 - 右下角检查是否显示
Go modules且状态为Loaded；若显示Not loaded，说明模块根识别失败，需右键项目 →Go → Change Directory to Module Root
真正麻烦的不是步骤多，而是顺序错：先go mod tidy再Reload，最后才Invalidate Caches。中间任何一步跳过，都可能导致索引重建时读到过期的模块快照。
