GoLand接口实现列表不更新主因是gopls缓存未刷新；需重启语言服务器或手动删除$GOCACHE/gopls目录，而非仅执行Invalidate Caches。

GoLand 的接口实现列表不更新，和 gopls 缓存有关

GoLand 里按 Ctrl+Click（macOS 是 Cmd+Click）跳转到接口定义后，右侧「Implementations」面板显示的实现列表卡在旧状态，新增的 func (T) Method() 不出现——这通常不是 GoLand 自身缓存问题，而是底层语言服务器 gopls 的语义分析缓存没刷新。GoLand 默认启用 gopls，所有符号查找、实现定位、补全都依赖它。

常见错误现象包括：

• 改了实现方法签名，但「Go to Implementation」仍列出旧函数
• 新建了一个实现 struct，重启 GoLand 后依然不显示
• 项目里有 //go:build ignore 或条件编译文件，gopls 错误地把它们当有效实现纳入索引

清理 gopls 缓存最直接有效的方法

gopls 的缓存默认存在 $GOCACHE 下的子目录（如 gopls/.../cache），但它不响应 go clean -cache。必须手动清或触发重载：

GoLand 2026.1.1

GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。

下载

• 在 GoLand 中按 Ctrl+Shift+A（macOS Cmd+Shift+A）打开「Find Action」，输入 Restart Language Server 并执行——这是最快方式，会强制 gopls 重新加载整个模块并重建符号索引
• 如果重启后仍不生效，关掉 GoLand，终端执行：rm -rf $(go env GOCACHE)/gopls，再启动
• 检查 GoLand 设置 → Go → Language Server → 「Build tags」是否填了干扰项（比如 dev），若当前代码用的是 prod 标签，这里填错会导致 gopls 跳过扫描对应文件

为什么不能只靠「Invalidate Caches and Restart」？

GoLand 的 Invalidate Caches and Restart（菜单 File → Invalidate Caches and Restart）会清 IDE 层面的索引（如文件名、语法高亮、本地历史），但它**不碰 gopls 进程的内存缓存或磁盘缓存目录**。而接口实现列表完全由 gopls 提供，IDE 只做展示。所以你点了「Invalidate」，看到「Scanning files to index…」进度条走完，但实现列表还是老的。

真正起作用的是 gopls 重启或其缓存目录删除——这点容易被忽略，尤其当你习惯性点「Invalidate」却没效果时。