GoLand 启动卡顿、补全失效、项目识别为“unknown module”，主因是旧缓存及配置残留未清干净，须同步删除 Cache、Application Support、Logs、Preferences、Saved Application State 及系统 plist 文件，并检查 Shell 环境变量与 go.mod/go.sum 一致性。

GoLand 启动卡在欢迎页、代码补全失效、项目识别为“unknown module”，八成是旧缓存没清干净。直接删 ~/Library/Caches/JetBrains/GoLand* 不够，必须同步清理配置、日志、偏好和状态文件，否则重装后 IDE 会立刻复活旧设置甚至错误 SDK 路径。

确认 GoLand 安装来源再动手

卸载方式决定残留位置——你上次是用 Toolbox、独立 .app 还是 Homebrew 装的？不先搞清这点，删错目录反而让问题更隐蔽：

• 执行 ls ~/jetbrains-toolbox/：有内容说明是 Toolbox 管理的，优先进 Toolbox UI 点「Uninstall」，别手动删 /Applications/GoLand*.app
• 执行 brew list | grep goland：有输出就得用 brew uninstall goland，否则 /opt/homebrew/Cellar/ 下的二进制和 symlink 会残留
• 执行 ls /Applications/GoLand*.app：若存在且无 Toolbox 目录，才是独立安装，可右键移入废纸篓

特别注意：find ~ -iname "*goland*" 如果扫出大量 GoLand2024.3、GoLand2025.1 目录，但你从没手动装过——大概率是 Toolbox 自动部署的旧实例，必须先在 Toolbox 里删干净，再清理用户目录。

四类缓存目录必须全部删除

只删 Cache 目录，Application Support 里的插件配置、Preferences 里的快捷键映射、Saved Application State 里的窗口布局都会原样恢复，等于白清：

• 配置目录：rm -rf ~/Library/Application\ Support/JetBrains/GoLand*（含插件、主题、VCS 设置）
• 缓存目录：rm -rf ~/Library/Caches/JetBrains/GoLand*（含索引、符号表、临时编译产物）
• 日志与偏好：rm -rf ~/Library/Logs/JetBrains/GoLand* + rm -rf ~/Library/Preferences/JetBrains/GoLand*
• 系统级状态：rm -f ~/Library/Preferences/com.jetbrains.goland.plist + rm -rf ~/Library/Saved\ Application\ State/com.jetbrains.goland.savedState

命令中用 GoLand* 是为了匹配所有版本号（如 GoLand2026.1.1），不用手猜；macOS 上路径带空格必须加反斜杠转义，否则报错 No such file or directory。

GoLand 2026.1.1

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

下载

检查 Shell 环境变量是否残留 GOPATH/GOPAT

老版本 GoLand 安装器可能在 ~/.zshrc 或 ~/.bash_profile 里写死 GOPAT（注意不是 GOPATH）或错误的 PATH 条目，导致新装 IDE 启动时加载错 SDK：

• 执行 grep -n "goland\|GOPAT" ~/.zshrc ~/.bash_profile 2>/dev/null
• 如果输出类似 ~/.zshrc:42:export GOPAT="/Users/xxx/Library/Caches/JetBrains/GoLand2024.3"，手动删掉该行
• 改完后执行 source ~/.zshrc 生效，再启动 GoLand 验证

Windows 用户对应检查 %USERPROFILE%\AppData\Roaming\JetBrains\GoLand* 和 setx 输出，Linux 用户查 ~/.profile 和 ~/.bashrc。

重装后仍异常？重点看 go.mod 和 go.sum 是否被污染

缓存清得再干净，如果项目里 go.mod 指向一个已删的本地 replace 路径，或 go.sum 校验失败，GoLand 仍会卡在模块解析阶段：

• 执行 go mod verify 检查校验和一致性；失败就运行 go mod tidy -v 重建依赖树
• 若用私有模块，确认 go env GOPRIVATE 已设，否则清理后 go mod download 可能因跳过校验拉错版本
• 首次启动 GoLand 时加 -v 参数（macOS：右键 GoLand.app → 显示包内容 → Contents/bin/goland.vmoptions，末尾加 -Didea.log.debug.mode=true），看日志里是否出现 checksum mismatch 或 invalid version: unknown revision

最容易被忽略的是：go clean -modcache 不影响项目内 go.mod 和 go.sum，但 GoLand 的模块解析器会读取它们——缓存清了，依赖声明却没更新，IDE 就会反复尝试拉不存在的版本。