GoLand标红但可正常编译运行，本质是符号索引缓存失效导致IDE无法解析引用；需执行File→Invalidate Caches and Restart强制重建索引，禁用自动构建和文件监听可提升成功率。
GoLand 标红但能正常编译：大概率是索引没跟上
这不是代码问题，而是 GoLand 自己的符号索引缓存（symbol index）和文件状态不一致导致的。常见于刚 clone 项目、重命名结构体、移动文件、或 go.mod 被手动编辑后。它不会影响 go build 或 go run，但补全、跳转、Find Usages 全部失灵，标红还带“undefined symbol”提示。
必须用 Invalidate Caches，不是清 $GOCACHE
go clean -cache 清的是 Go 编译器的中间产物（.a 文件），对 IDE 的 Go 符号索引完全无效。GoLand 的索引是独立维护在 ~/Library/Caches/JetBrains/GoLand* 和 ~/Library/Application Support/JetBrains/GoLand* 下的，得走 IDE 内置通道清理：
- 点击顶部菜单 File → Invalidate Caches and Restart…
- 勾选 Invalidate and Restart（别选 Just Restart）
- 等 IDE 完全退出再重启，左下角出现 Indexing 进度条时别打断
这个操作会强制重建整个 Go 项目的包依赖图、函数签名、结构体字段、import 路径映射——这才是解决“跳转失败”“补全消失”“标红但可运行”的唯一可靠方式。
索引卡住或反复出错？关掉自动构建再试
如果 Invalidate 后仍反复卡在 indexing、或几秒后又开始标红，大概率是 GoLand 在保存时频繁触发 go list 和构建检查，干扰了索引流程。临时禁用它：
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- Settings → Go → Build Tags & Vendoring → 关掉 Build project automatically
- Settings → Tools → File Watchers → 禁用所有 Go 相关 watcher（如 go fmt、go vet）
做完这两步再执行一次 Invalidate，成功率明显提升。注意：关掉自动构建不影响你手动运行 go run 或调试，只是停掉 IDE 背后的隐式检查。
清理完还残留旧 SDK 或模块路径？查 Toolbox 实例
如果 Invalidate + 重启后，项目依旧识别不到 go.mod、报 “No SDK configured”，说明 GoLand 正在加载旧的全局配置，而不是当前项目设置。这种情况多见于用 JetBrains Toolbox 安装过多个 GoLand 版本：
- 打开 Toolbox → Settings → Instances → 找到所有 GoLand 条目
- 逐个点垃圾桶图标 → 选 Uninstall（不是 Remove）
- 再手动删掉残留：
rm -rf ~/Library/Application\ Support/JetBrains/GoLand*和rm -rf ~/Library/Caches/JetBrains/GoLand*
Toolbox 不卸载干净，新装的 GoLand 会直接复用旧实例的 SDK 绑定和模块缓存路径，索引从一开始就是错的。
