GoLand代码规范校验不依赖专用缓存,而是由gopls语言服务器实时分析,其索引驻留内存并辅以磁盘缓存(如~/Library/Caches/JetBrains/GoLand2026.1/gopls),问题多因gopls未重载配置或AST未重建,应优先重启gopls服务而非清缓存。

GoLand 的代码规范校验缓存存在哪
GoLand 本身不生成“代码规范校验专用缓存”,它依赖 gopls(Go language server)做实时分析,而 gopls 的缓存主要落在两个地方:$GOCACHE(编译中间产物)和 $GOMODCACHE(模块源码),但真正影响“语法高亮错、import 红线不消失、linter 报旧错误”的,往往是 gopls 进程内部的内存索引 + 本地磁盘上的 cache 目录(默认在 $HOME/Library/Caches/JetBrains/GoLand2026.1/gopls macOS / %LOCALAPPDATA%\JetBrains\GoLand2026.1\gopls Windows)。
为什么改了 gofmt/golint 配置后红线还在
这不是缓存没清,而是 gopls 没重载配置或没重建 AST 索引。常见现象包括:
- 改了
.golangci.yml后 linter 不生效 - 启用了
goimports但格式化仍不用它 - 删了
import "fmt",但编辑器还显示 “unused import” 提示
这时清磁盘文件没用,关键动作是重启语言服务:
- 快捷键
Ctrl+Shift+Alt+H(Windows/Linux)或Cmd+Shift+Option+H(macOS)强制重启gopls - 或者在 Settings → Languages & Frameworks → Go → Language Server → 点击
Restart Server - 确保
Settings → Editor → Inspections → Go下勾选了对应检查项,且未被build tags屏蔽
要不要手动删 JetBrains 的 gopls cache 目录
一般不需要。删了只会让 gopls 下次启动时多花几秒重建索引,不会修复配置错误。但以下情况可考虑手动清理:
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本,适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 升级 GoLand 后频繁报
failed to load workspace或no packages matched - 项目根目录下有多个
go.work或嵌套go.mod,gopls索引混乱 - 磁盘空间告急,且确认该目录(如
~/Library/Caches/JetBrains/GoLand2026.1/gopls)占了几个 GB
执行前先关掉 GoLand,再运行:
rm -rf ~/Library/Caches/JetBrains/GoLand2026.1/gopls/*
注意末尾的 /* —— 别直接删整个 gopls 文件夹,否则可能丢失日志路径配置。
比清缓存更有效的日常维护动作
真正影响规范校验准确性的,不是缓存大小,而是环境一致性:
- 确保
GO111MODULE=on,避免gopls误入 GOPATH mode 导致 module resolution 失败 - 在 Settings → Go → Build Tags & Vendoring 中,把
Build tags设为与 CI 一致(比如dev),否则gopls可能跳过部分文件导致 import 错误不报 - 不要在
Settings → Editor → Code Style → Go里改缩进/换行规则后就以为生效——必须点Apply再点OK,否则gofmt插件仍用默认值 - 如果用
golangci-lint,确认Settings → Tools → golangci-lint中路径指向的是项目bin/下的二进制,而非全局安装的旧版本
最常被忽略的是:GoLand 的 gopls 默认不读取项目根目录下的 .editorconfig,哪怕你写了 indent_style = tab,它也只认自己设置里的缩进逻辑。

















