GoLand的索引依赖Content Root配置而非$GOCACHE，清理缓存无效；需手动将vendor/或replace路径添加为Sources并等待索引完成，才能解决跳转失效、补全不准等问题。
GoLand 的“索引”不是缓存，不能靠“清理缓存”解决跳转失效、补全不准等问题；真正要动的是 Content Root 配置和符号索引范围。
为什么 go clean -cache 对 GoLand 索引没用
go clean -cache 只清 $GOCACHE（编译中间产物），不影响 IDE 的语义索引。GoLand 的跳转、重构、引用查找依赖的是它自己构建的符号表，该表只扫描被标记为 “Sources” 的目录。即使你删光了 $GOCACHE，如果 vendor/ 或 replace 本地路径没加进 Content Root，IDE 依然看不到那些代码。
- 常见错误现象：
Ctrl+Clickimport 名提示 “Cannot find declaration to go to”，但go list -m all能查到模块 - 根本原因：IDE 没把对应源码路径纳入索引范围，不是缓存脏了
- 性能影响：误以为清缓存能提速，实际只是白等 indexing 进度条反复刷
手动添加 vendor/ 或 replace 路径为 Sources 才是关键
GoLand 默认不识别 vendor/ 目录或 replace 指向的本地路径为源码根。必须显式添加并标记为 Sources：
GoLand 2026.1.1
下载
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 确认路径存在且合法：运行
go mod vendor后检查vendor/非空；replace指向的目录（如../lib）下必须有go.mod - Settings → Directories → Add Content Root → 选择
vendor/或../lib - 添加后右侧类型必须是 Sources（不是 Excluded、不是 Libraries）
- 等待右下角提示 “Indexing completed”，此时光标停在 import 上
Ctrl+Click应能跳转到本地文件
什么时候才需要真正“重建索引”
仅当以下情况发生时，才考虑触发完整重建（File → Reload project 或 Invalidate Caches）：
- 修改了
go.mod中大量replace，且已添加路径但跳转仍错乱 - 升级 GoLand 到新大版本（如从 2025.3 → 2026.1），旧索引结构不兼容
- 手动改过
$GOPATH/pkg/mod下的源码（不推荐），导致符号冲突 - 注意：
Invalidate Caches and Restart会清空所有本地索引、插件设置、断点历史，不是日常操作
最常被忽略的一点：索引生效与否，和你是否在 go.mod 里写了 replace 无关，只和 IDE 是否“看见”那个本地路径有关。加完 Content Root 后别急着点重建，先等 indexing 完成——这个过程可能持续几十秒到几分钟，取决于路径下文件数量。
