GoLand缓存必须分两套彻底清理:IDE自身缓存(如~/Library/Caches/JetBrains/GoLand*)解决标红、补全失效;Go工具链缓存($GOCACHE、$GOMODCACHE)解决依赖解析错乱与磁盘占用,仅Invalidate Caches不够,需手动清除配置、缓存、日志及gopls状态。

GoLand 缓存不清理,项目标红、补全失效、启动卡死都是常态
GoLand 的缓存不是“可有可无”的附加项,而是它解析模块、索引符号、维护语言服务器状态的核心载体。缓存出问题,go mod tidy 有效但 IDE 仍标红、gopls 频繁重启、甚至新建项目都识别不出 main 函数——这些都不是代码问题,是缓存脏了。
关键点在于:GoLand 有两套缓存体系,必须分开处理:
-
~/Library/Caches/JetBrains/GoLand*(macOS)或%LOCALAPPDATA%\JetBrains\GoLand*\Cache(Windows):IDE 自身的 UI、索引、插件运行时缓存,删它能解决卡顿、误提示、界面异常 -
$GOCACHE和$GOMODCACHE:Go 工具链的构建与模块缓存,GoLand 只调用,不管理,删它们才能真正释放磁盘、避免依赖解析错乱
别只点 Invalidate Caches and Restart —— 它只清第一类,且不删 .vmoptions 或 savedState,残留照样引发闪退。
彻底清理 GoLand 缓存的四步命令(macOS / Linux)
终端里逐条执行,顺序不能乱,否则可能触发 IDE 启动失败:
-
rm -rf ~/Library/Application\ Support/JetBrains/GoLand*→ 清配置和插件状态(含旧版代理、replace规则、自定义 SDK 路径) -
rm -rf ~/Library/Caches/JetBrains/GoLand*→ 清索引快照和 UI 缓存(解决补全延迟、跳转失效) -
rm -rf ~/Library/Logs/JetBrains/GoLand*→ 清日志(避免崩溃后反复加载错误堆栈) -
rm -f ~/Library/Preferences/com.jetbrains.goland.plist→ 清系统级偏好(尤其影响启动参数和 Gatekeeper 权限标记)
Windows 用户对应路径为:%APPDATA%\JetBrains\GoLand*、%LOCALAPPDATA%\JetBrains\GoLand*\Cache、%LOCALAPPDATA%\JetBrains\GoLand*\log。删完务必重启终端再开 GoLand,否则环境变量未重载,go env 仍读旧值。
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本,适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
项目配置备份要避开三个坑
直接压缩 ~/.GoLand2026.1 或 ~/Library/Application Support/JetBrains/GoLand2026.1 是最常见错误——里面混着机器指纹、临时 token、加密密钥,还原到另一台设备上大概率导致登录失败、插件授权失效、甚至 gopls 拒绝连接。
- 只备份
settings.jar(位于~/Library/Caches/JetBrains/GoLand2026.1/caches/下):这是 GoLand 官方导出的纯设置包,不含敏感信息,导入时自动适配新环境 - 手动提取关键配置文件:
codestyles/(代码风格)、keymaps/(快捷键)、templates/(Live Templates),它们都在~/Library/Application Support/JetBrains/GoLand2026.1/options/内,可单独拷贝 - 不要备份
plugins/目录:插件二进制本身跨平台不兼容,新版插件常带 JVM 字节码签名,硬拷过去会触发PluginException: Plugin 'xxx' is incompatible
备份前先确认 GoLand 版本号(Help → About),不同大版本(如 2025.x vs 2026.x)的 settings.jar 不互通。
go.mod + go.work 项目必须额外清理语言服务器状态
多模块项目(尤其是用了 go.work)下,gopls 会维护一份独立于 IDE 的缓存状态,存在 ~/.cache/gopls(Linux/macOS)或 %LOCALAPPDATA%\gopls(Windows)。这个目录不会被 Invalidate Caches 触及,但一旦损坏,会导致整个工作区无法加载、import 标红永不消失。
- 删它:
rm -rf ~/.cache/gopls(macOS/Linux)或Remove-Item -Recurse -Force $env:LOCALAPPDATA\gopls(PowerShell) - 删完别急着开项目,先在终端跑一次:
go work use ./module-a ./module-b,确保go.work路径合法,再启动 GoLand - 如果项目含
replace指向本地路径(如replace example.com/foo => ../foo),检查../foo是否存在且可读——gopls会静默跳过不可访问路径,不报错但也不索引
最后提醒一句:清理 $GOMODCACHE 前,务必先确认 go env GOMODCACHE 输出的是你预期的路径;否则 go clean -modcache 会把 C 盘旧缓存全删掉,而新路径下仍是空的,下次 go mod download 就得重拉全部依赖。

















