必须手动清除 JetBrains 生成的配置与缓存目录,包括 ~/Library/Application Support/JetBrains/GoLand、~/Library/Caches/JetBrains/GoLand、~/Library/Logs/JetBrains/GoLand、~/Library/Preferences/JetBrains/GoLand 及两个系统级文件 com.jetbrains.goland.plist 和 com.jetbrains.goland.savedState。

GoLand 启动失败、卡在欢迎页、补全失效或项目识别异常,90% 是缓存残留导致的——不是重启 IDE 能解决的,必须手动清掉 JetBrains 生成的配置与缓存目录。
GoLand 启动卡死或欢迎页不消失
这不是网络问题,也不是 license 验证失败,而是旧版配置被新版本错误加载。GoLand 2026.1+ 对 GoLand* 目录结构更敏感,残留的 Saved Application State 或 Preferences 会阻塞初始化流程。
- 先关掉所有 GoLand 窗口和后台进程(macOS 可执行
killall goland;Windows 用任务管理器查杀jetbrains-go-*.exe) - 删掉这四个核心目录(路径含版本号通配,不用猜):
~/Library/Application Support/JetBrains/GoLand*~/Library/Caches/JetBrains/GoLand*~/Library/Logs/JetBrains/GoLand*~/Library/Preferences/JetBrains/GoLand* - 再删两个易忽略的系统级文件:
~/Library/Preferences/com.jetbrains.goland.plist~/Library/Saved Application State/com.jetbrains.goland.savedState
重装后还是加载旧设置或错误 SDK
说明你没清理干净 Toolbox 实例或 Shell 环境变量。JetBrains Toolbox 会自动挂载旧配置,且某些老版本会在 ~/.zshrc 里硬编码 GOROOT 或 GOBIN,干扰新安装的 SDK 识别。
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本,适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 检查是否用 Toolbox 安装:运行
ls ~/jetbrains-toolbox/,如果存在,打开 Toolbox → Settings → Instances → 找到 GoLand 条目 → 点垃圾桶图标 → 选「Uninstall」 - 搜索 Shell 配置文件里的残留:
grep -n "GOROOT\|GOBIN\|GOPATH" ~/.zshrc ~/.bash_profile 2>/dev/null
找到就手动注释或删除对应行 - 确认新安装的 GoLand 是否读到了正确 SDK:启动后进
Settings → Go → GOROOT,看路径是否指向你当前go env GOROOT的输出,而不是旧版本路径
Go 编译/模块缓存仍影响构建结果
GoLand 本身不控制 GOCACHE 和 GOMODCACHE,但它的后台分析进程(如代码索引、test runner)会持续读写这些目录。如果你改了 CGO_ENABLED、切换了 GOOS 或升级 Go 版本后构建行为异常,光清 IDE 缓存没用。
- 确认并清理 Go 编译缓存:
执行go clean -cache(清$GOCACHE)
再手动删掉go env GOCACHE输出的目录(尤其 Windows 上是%LOCALAPPDATA%\go-build) - 清理模块缓存(非日常操作,只在迁移/代理切换/校验失败时做):
执行go clean -modcache,不是go mod tidy或go get -u
删完立刻运行go mod download触发重拉,否则首次go build会卡在 downloading - 注意路径一致性:别信
$GOPATH/pkg/mod,一定用go env GOMODCACHE确认真实路径,多 GOPATH 或 CI 环境下二者常不一致
真正卡住人的永远不是「该不该清」,而是清哪几个目录、清完要不要补操作、以及哪些地方不能靠 IDE 界面点几下就完事——比如 GOCACHE 必须设环境变量,GoLand* 目录必须通配删除,go clean -modcache 后必须跟 go mod download。漏掉任意一环,问题就会原样复现。

















