必须手动删除四类 JetBrains 用户级目录(Application Support、Caches、Logs、Preferences)及 go mod 缓存(go clean -modcache),Invalidate Caches 不足以清除配置、插件、SDK 路径等持久化残留,Toolbox 实例和 Shell 环境变量也需同步清理。

GoLand 缓存不清理,轻则补全卡顿、依赖标红、模块识别失败,重则启动卡在欢迎页、配置错乱、新版本沿用旧 SDK 路径。这不是“重启一下就好”的问题,而是缓存目录和模块缓存双重污染的结果。
GoLand 自身缓存必须手动删,Invalidate Caches 不够用
GoLand 的 Invalidate Caches and Restart 只清 IDE 运行时缓存(如索引、符号表),但不会动以下四类用户级持久目录,它们才是重装后“旧设置复活”“插件失效”“主题错乱”的根源:
-
~/Library/Application Support/JetBrains/GoLand*—— 存配置、插件、模板、自定义快捷键 -
~/Library/Caches/JetBrains/GoLand*—— 存编译中间产物、代码分析快照、字体渲染缓存 -
~/Library/Logs/JetBrains/GoLand*—— 日志里常含路径错误、模块加载失败的线索 -
~/Library/Preferences/JetBrains/GoLand*—— 偏好设置(如 GOPATH、GOROOT、代理配置)全在这里
执行这四条命令才真正清干净:
rm -rf ~/Library/Application\ Support/JetBrains/GoLand* rm -rf ~/Library/Caches/JetBrains/GoLand* rm -rf ~/Library/Logs/JetBrains/GoLand* rm -rf ~/Library/Preferences/JetBrains/GoLand*
注意:GoLand* 会匹配所有带 GoLand 的目录(如 GoLand2026.1、GoLand2025.3.2),不用猜版本号。
go mod 缓存要单独清,和 GoLand 缓存无关
GoLand 标红 github.com/gin-gonic/gin?不是 IDE 问题,是 Go 模块系统本地缓存出问题。GoLand 依赖 $GOPATH/pkg/mod 下的真实模块文件做语义分析,这个目录和 JetBrains 缓存完全隔离。
- 执行
go clean -modcache彻底清空$GOPATH/pkg/mod - 再运行
go mod tidy重新拉取依赖、更新go.mod和go.sum - 如果用了私有代理(如
GOPROXY=https://goproxy.cn),确认该环境变量仍在生效(检查~/.zshrc或~/.bash_profile)
常见误操作:只点 Invalidate Caches 就去写代码,结果 import 依旧标红——因为模块文件根本没重下。
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本,适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
Toolbox 安装的 GoLand,残留更隐蔽
如果你用 JetBrains Toolbox 安装过 GoLand,它会在后台悄悄创建实例目录和状态文件,即使你删了 /Applications/GoLand.app,这些仍存在:
-
~/jetbrains-toolbox/目录下可能有goland-2026.1.1这类子目录,含完整配置快照 -
~/Library/Application Support/JetBrains/Toolbox/instances/存着每个实例的元数据和日志 - Toolbox 自己的缓存(
~/Library/Caches/JetBrains/Toolbox/)也可能干扰新安装行为
正确做法:先打开 Toolbox → Settings → Instances → 找到 GoLand 条目 → 点垃圾桶选 Uninstall;卸载完再手动删上面两个路径。
容易被忽略的 Shell 环境变量残留
老版本 GoLand 在首次配置 SDK 时,可能往 ~/.zshrc 或 ~/.bash_profile 写入过时的 export GOPATH=... 或 export GOROOT=...。这些语句一旦存在,就会覆盖当前 Go 安装的实际路径,导致 go build 正常但 GoLand 报“SDK not configured”。
检查并删掉这类行:
grep -n "GOPATH\|GOROOT" ~/.zshrc ~/.bash_profile 2>/dev/null
尤其警惕注释掉但未删除的旧配置——GoLand 启动时仍会读取它们。

















