清理缓存后gopls失效，根本原因是gopls二进制丢失或路径未正确配置；需执行go install golang.org/x/tools/gopls@latest，确认$GOPATH/bin/gopls存在且可执行，GoLand中手动指定该路径并重启。
GoLand清理缓存后gopls不工作怎么办
缓存清完，代码补全、跳转定义、错误提示全失效，不是插件崩了，是gopls二进制丢了或路径断了。GoLand的Language Server（gopls）不会随IDE缓存自动重装，它依赖你本地go install生成的可执行文件。
实操建议：
- 终端执行
go install golang.org/x/tools/gopls@latest（注意不是go get） - 确认安装路径：
go env GOPATH输出后拼上/bin/gopls，例如$HOME/go/bin/gopls - 在GoLand中打开
Settings → Go → Language Server，勾选Use custom gopls binary，填入上一步的完整路径 - 检查该文件是否可执行：
chmod +x $HOME/go/bin/gopls（Linux/macOS）；Windows无需此步 - 重启GoLand，观察右下角是否显示
gopls (running)
GOROOT和GOPATH识别失败的快速修复
清理缓存后GoLand重置SDK配置，常见报错是GOROOT not set或cannot find SDK。这不是环境变量问题，而是IDE里没手动指定路径。
实操建议：
- 终端运行
go env GOROOT，取完整输出（如/usr/local/go），**不要用which go结果**（那是bin/go，末尾带/bin） - GoLand中进入
Settings → Go → GOROOT，点击...选择该路径，确保路径下有src、pkg、bin三个目录 - 若项目用Go Modules，
GOPATH其实无关紧要，但IDE仍会读取它来定位gopls；确认go env GOPATH输出合理，且$GOPATH/bin已加入系统PATH - 如果用Homebrew安装Go，路径可能在
/opt/homebrew/Cellar/go/1.24.0/libexec这类位置，必须手动选，IDE不会自动扫描
Go Modules未激活导致项目“变灰”
缓存清完，项目结构里所有.go文件变灰色、无语法高亮、go mod命令不响应——大概率是GoLand没加载模块上下文，不是go.mod丢了。
GoLand 2026.1.1
下载
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
实操建议：
- 右键项目根目录 →
Reload project（不是Reload from Disk） - 确认
go.mod第一行是合法module example.com/name，不能是空行或注释开头 - 终端进项目目录执行
go mod download，再回GoLand点右上角Load按钮（小闪电图标） - 进
Settings → Go → Modules，临时取消勾选Enable Go modules integration，点Apply，再勾选回来强制刷新
为什么go clean -cache不影响gopls但会影响构建速度
go clean -cache只清$GOCACHE（默认~/Library/Caches/go-build等），它和gopls完全无关，但会清掉编译中间对象，首次构建变慢是正常现象。
容易踩的坑：
- 误删
$GOPATH/pkg/mod：这是模块下载缓存，删了会导致go run反复拉包，速度骤降 - 以为
go clean -cache能重置gopls状态：不能，gopls的缓存存在$GOCACHE子目录里，但它的二进制和配置是独立的 - 清完缓存没重启GoLand：新gopls路径或GOROOT设置不会热生效，必须重启
最常被忽略的是gopls路径是否指向真实可执行文件——哪怕路径字符串看着对，如果$GOPATH/bin/gopls不存在或权限不对，IDE就只会静默降级为无LS模式，连报错都不给。
