Invalidate Caches 能解决标红问题，因为 GoLand 依赖独立于 Go 工具链的本地符号索引实现跳转、补全和错误提示，索引滞后或错乱会导致标红而 go build 正常。
GoLand 标红但 go build 正常，基本就是索引或缓存坏了，不是代码问题，别花时间改逻辑。
为什么 Invalidate Caches 能解决大部分标红问题
GoLand 依赖本地符号索引做跳转、补全和错误提示。一旦文件移动、包名变更、go.mod 修改或项目刚 clone，索引就可能滞后甚至错乱——比如明明 Options 在 api/type.go 里定义了，IDE 却报 undefined symbol。
这个索引是独立于 Go 工具链的，go build 不走它，所以能过；但 IDE 的红色波浪线、Ctrl+Click 跳转失败、Find Usages 找不到引用，全是因为索引没对上。
- 点击 File → Invalidate Caches and Restart… → Invalidate and Restart
- 重启后等左下角
Indexing消失（通常几秒到一分钟，取决于项目大小） - 别在索引完成前操作，否则可能再次卡住或漏建
go clean -modcache 是清理依赖缓存，不是 IDE 缓存
很多人混淆这两类缓存：go clean -modcache 清的是 $GOMODCACHE（默认 $GOPATH/pkg/mod）里的模块 zip 包和解压源码，不影响 IDE 索引；它解决的是 invalid version: unknown revision、checksum mismatch 或磁盘占满等问题。
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 执行前先确认路径：
go env GOMODCACHE - 执行命令：
go clean -modcache（Go 1.12+ 均支持） - 清理后首次
go build会慢，但只重拉缺失或校验失败的模块，不是全部 - 如果
go list -m all输出里有(incompatible)或missing，说明缓存已损坏，此时应配合go mod tidy一起用
手动删指定模块缓存比全量清理更精准
CI 构建或多人共用 GOPATH 时，go clean -modcache 会强制重拉所有模块，浪费带宽和时间。真要重拉某个版本（比如 github.com/gin-gonic/gin@v1.9.1），直接删对应目录更高效。
- 查路径：
echo $GOMODCACHE（注意 Windows 用%GOMODCACHE%） - 删目录：
rm -rf $GOMODCACHE/github.com/gin-gonic/gin@v1.9.1 - 再执行：
go mod download github.com/gin-gonic/gin@v1.9.1 - 删完不立刻生效：checksum 文件（如
cache/download/github.com/gin-gonic/gin/@v/v1.9.1.info）要等go mod download时重建，旧的校验残留可能引发后续go mod verify失败
同步 Go Modules 图标点不动？试试 Repair IDE
GoLand 右上角那个蓝色“Go Modules”同步图标有时灰掉或点击无反应，常见原因是后台语言服务器卡死或模块解析状态异常，不是网络或权限问题。
这时比反复点图标更可靠的操作是：
- 点击 File → Repair IDE…
- 选 Rescan Project Indexes（不是 “Reload project”）
- 它会强制触发一次完整的 Go module 解析 + 符号索引重建，比单纯 Invalidate Caches 更聚焦于模块上下文
- 如果项目用了
replace或私有代理，确保go env GOPROXY和GOPRIVATE已设好，否则 Rescan 会跳过部分模块
真正容易被忽略的是：索引修复和模块缓存清理是两件事，必须分清触发条件。标红 ≠ 依赖错，go build 成功 ≠ IDE 看得懂，别指望一个操作解决所有“看着不对”的问题。
