必须删除 JetBrains 配置目录，否则旧设置会污染新版本；执行 rm -rf ~/Library/Application\ Support/JetBrains/GoLand\* 清除全部残留，包括配置、插件和缓存，并同步清理 $GOCACHE、$GOMODCACHE 及修正 GOROOT/GOPATH 环境变量。
GoLand 升级后必须删 JetBrains 配置目录，否则旧设置会污染新版本
升级 GoLand（比如从 2025.3 到 2026.1.1）后直接启动，大概率遇到项目不识别、插件失效、补全卡顿或卡在欢迎页——这不是 Bug，是旧版配置被自动加载导致的。JetBrains 系统默认复用 ~/Library/Application Support/JetBrains/GoLand* 下的配置，哪怕你装了新 App，它仍会读 GoLand2025.3 目录里的 settings.xml、keymaps、plugins。
执行以下命令一次性清除所有旧版残留：
rm -rf ~/Library/Application\ Support/JetBrains/GoLand*
注意：GoLand* 是通配符，会匹配 GoLand2025.1、GoLand2025.3、GoLand2026.1 等全部子目录，无需手动判断版本号。
- 别只删
GoLand2025.3，留着GoLand2025.1同样会触发冲突 - 如果用 Toolbox 安装，删完后需重启 Toolbox 才能刷新实例列表
- 删完首次启动是全新配置，主题、快捷键、编码风格都要重设
GoLand 升级后构建缓存也要清，$GOCACHE 和 $GOMODCACHE 是两回事
GoLand 自身不管理 Go 编译缓存，但升级后 IDE 调用 go build 或 go test 时，会复用系统级的 $GOCACHE（编译中间产物）和 $GOMODCACHE（模块源码）。这两者不随 IDE 升级自动清理，且可能因 Go 版本变更（如从 1.24 升到 1.26）导致静默链接失败或符号找不到。
分步清理更安全：
- 清 Go 构建缓存：
go clean -cache（路径默认是~/Library/Caches/go-build） - 清模块缓存：
go clean -modcache（路径默认是$(go env GOPATH)/pkg/mod） - 如果刚升级 Go 本身，再加一条：
go clean -i（删$GOBIN下旧版go install生成的二进制）
特别注意：go clean -modcache 会清空所有已下载模块，首次 go build 会变慢；但比依赖错乱、go.sum 校验失败强得多。
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
升级后检查 Shell 环境变量，GOROOT/GOPATH 指向旧 Go 会导致 IDE 行为异常
GoLand 启动时会读终端环境变量，尤其是 GOROOT 和 GOPATH。如果你之前用 Homebrew 装过 Go，又手动下载新版解压到 /usr/local/go，但 ~/.zshrc 里还留着 export GOROOT=/opt/homebrew/opt/go/libexec，那 GoLand 就会用旧 GOROOT 下的 go 命令，结果是：SDK 检测失败、gopls 启动报错、甚至 go mod download 走错代理。
验证并修复方法：
- 在终端运行：
go env GOROOT GOPATH，确认输出路径与你当前安装的 Go 一致 - 搜所有 shell 文件：
grep -n "GOROOT\|GOPATH" ~/.zshrc ~/.bash_profile ~/.profile - 删掉旧 export 行，然后
source ~/.zshrc，再重启 GoLand
Windows 用户重点检查 %USERPROFILE%\AppData\Roaming\JetBrains\GoLand2026.1\idea.properties 是否硬编码了旧路径。
Toolbox 安装的 GoLand 升级后，别漏掉 Instances 的缓存隔离
用 JetBrains Toolbox 安装 GoLand，升级不是覆盖原 App，而是新增一个 GoLand 2026.1.1 实例，同时保留 GoLand 2025.3 实例。两者共享同一套用户配置目录（~/Library/Application Support/JetBrains/），但 Toolbox 会在每个实例下维护独立的插件缓存和索引数据，藏在 ~/Library/Caches/JetBrains/GoLand2026.1.1/ 里。
如果你升级后发现代码跳转不准、结构视图空白、或者提示 “Indexing paused”，说明旧实例的缓存没被新实例接管。此时要：
- 打开 Toolbox → Settings → Instances → 找到旧版 GoLand 条目 → 点垃圾桶图标 → 选「Uninstall」
- 手动删旧缓存目录：
rm -rf ~/Library/Caches/JetBrains/GoLand2025.3* - 重启 Toolbox 和新 GoLand，让它重建索引
最容易被忽略的是：Toolbox 默认不会自动删旧实例的缓存，哪怕你已经卸载了那个 App。不手动清，新版本可能反复读取旧索引导致内存泄漏或 CPU 占用飙高。
