答案是必须执行Invalidate Caches and Restart操作；该操作安全清空符号索引缓存、保留用户设置，并在重启后自动全量重建模块解析与引用关系，解决标红但可运行的假报错问题。
GoLand重启前必须执行Invalidate Caches操作
GoLand的“标红但能跑通”问题，90%以上是符号索引缓存失效导致的假报错，比如Options结构体被标红、跳转定义失败、自动补全不出现。它不依赖你手动删文件，而是必须走IDE内置的缓存清理流程——因为索引数据分散在多个隐藏目录（$USER_HOME/.cache/JetBrains/GoLand202X.x、$USER_HOME/.config/JetBrains/GoLand202X.x等），手动删容易漏或误删配置。
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
File → Invalidate Caches and Restart 是唯一可靠路径
别用第三方脚本或自己去.cache里找目录删，GoLand的索引重建逻辑 tightly coupled 到这个菜单项。触发后它会：
- 安全清空所有语言服务缓存（包括gopls状态、模块解析树、符号引用图）
- 保留你的Keymap、Editor Colors、Live Templates等用户设置
- 重启后自动触发全量索引，且优先加载当前项目go.mod声明的模块路径
- 左下角出现Indexing...提示时，说明正在重建，此时不要急着写代码或运行
哪些情况必须先做这一步再重启
以下场景不做Invalidate Caches and Restart，重启等于白重启：
- 刚从Git clone一个新Go项目，所有import都标红
- 修改了go.mod中的module名，但IDE仍按旧路径解析符号
- 重命名了包目录（比如把api/改成handler/），跳转定义指向404
- 升级GoLand后，go run在终端秒出结果，但在IDE里卡在“Loading modules…”
- go mod tidy在终端成功，但IDE里github.com/gofiber/fiber/v2仍显示“cannot find package”
清理后仍标红？重点检查GOPROXY和go.work干扰
如果做完Invalidate and Restart后还是有未定义符号，问题已不在缓存层：
- 在GoLand内置终端里运行go env GOPROXY，确认输出不是direct或空值；若不对，进Settings → Go → Go Modules手动填入https://goproxy.cn
- 检查项目根目录是否存在go.work文件，它会强制覆盖单个go.mod，导致模块路径解析错乱；存在就删掉，或临时执行go env -w GOWORK=off
- 运行go list -m all | grep fiber（以Fiber为例），看输出的模块路径是否和代码中import语句完全一致，大小写、版本后缀（/v2）、斜杠方向都不能差
