gosublime 不能配 lsp-gopls，因其非lsp客户端，与gopls无兼容层；必须用官方lsp插件替代gosublime，并确保gopls已安装、path正确、项目含go.mod或符合gopath结构。
为什么不能直接用 GoSublime 配 LSP-gopls
GoSublime 本身不是 LSP 客户端，它自带一套独立的语法检查和补全逻辑（基于 gocode / guru），和 lsp-gopls 无兼容层。强行在 GoSublime 里塞 gopls 配置，只会导致命令冲突、诊断重复或根本无响应。
真正能跑 gopls 的 Sublime Text 插件只有 LSP（官方推荐客户端），而 GoSublime 和 LSP 必须二选一——不是“配合”，是“替换”。
LSP 插件安装与 gopls 二进制准备
先确保系统已装好 gopls：运行 go install golang.org/x/tools/gopls@latest，完成后执行 gopls version 确认路径可用（通常在 $HOME/go/bin/gopls 或 %USERPROFILE%\go\bin\gopls.exe）。
Sublime Text 中：
- 用 Package Control 安装
LSP插件（不是LSP-json或其他变体） - 重启 Sublime Text，按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入LSP: Enable Language Server Globally，选中gopls - 若没自动识别，需手动配置：打开
Preferences → Package Settings → LSP → Settings，在右侧用户设置中填入：
{
"clients": {
"gopls": {
"enabled": true,
"command": ["gopls"],
"initializationOptions": {
"usePlaceholders": true,
"completeUnimported": true
},
"settings": {
"gopls": {
"build.experimentalWorkspaceModule": true
}
}
}
}
}
项目根目录必须含 go.mod 或 GOPATH 有效
gopls 启动时会向上查找 go.mod；找不到则 fallback 到 GOPATH 下的 src/ 结构。如果只是打开单个 .go 文件且不在模块内，gopls 会静默失败，LSP 状态栏显示 “not initialized” 或反复重启。
验证方式：
- 终端进入项目目录，运行
go env GOMOD，应返回go.mod绝对路径 - 或确认当前文件路径符合
$GOPATH/src/example.com/foo/main.go格式 - Sublime Text 必须用
File → Open Folder...打开整个模块根目录，而非只打开单个文件
常见报错与绕过技巧
现象：LSP: gopls failed to start: 'gopls' is not recognized
- Windows：把
%USERPROFILE%\go\bin加进系统PATH，或改LSP配置里的"command"为绝对路径，如["C:/Users/xxx/go/bin/gopls.exe"] - macOS/Linux：检查 shell 的
PATH是否包含$HOME/go/bin；Sublime Text 若非终端启动，可能不继承 shell PATH，此时必须写绝对路径
现象：no workspace packages 或补全失效
- 删掉项目下
gopls缓存：rm -rf $HOME/Library/Caches/gopls（macOS）或对应路径 - 关闭所有 Sublime 窗口，清空
~/.config/sublime-text-4/Cache/LSP/（Linux/macOS）或%APPDATA%\Sublime Text\Cache\LSP\（Windows） - 确保
go命令本身可用（go version能输出）——gopls严重依赖go工具链
gopls 对 Go 版本敏感，1.21+ 推荐用 gopls@v0.14+；低于 1.20 的项目建议锁定 gopls@v0.13.3，否则诊断可能漏报。
