gopls是go官方唯一推荐的语言服务器，sublime需通过lsp+lsp-go插件硬编码其绝对路径配置，并确保go和gopls已用go install安装、项目含go.mod、working_dir正确，同时卸载gosublime等冲突插件。
gopls 是当前唯一被 Go 官方推荐、持续维护的语言服务器，Sublime Text 要真正支持 Go（跳转定义、补全、格式化、诊断），必须靠它，而不是靠 GoSublime 这类已停更插件。
Sublime 启动后找不到 go 或 gopls 命令
这不是插件问题，是 Sublime（尤其是 macOS GUI 启动或 Windows 开始菜单启动）压根没继承 shell 的 $PATH。终端里 go version 和 gopls version 都正常，Sublime 里照样报 command not found。
- 先在终端执行
which go和which gopls，记下完整路径，比如/usr/local/go/bin/go和/Users/you/go/bin/gopls - macOS 用户确认
export PATH="/usr/local/go/bin:/Users/you/go/bin:$PATH"已写入~/.zshrc，并执行source ~/.zshrc - Windows 用户必须把
go.exe和gopls.exe所在目录（如C:/Go/bin、%USERPROFILE%/go/bin）加进「系统级」环境变量PATH，仅用户变量无效 - 终极兜底：打开
Preferences → Settings – User，加"env": {"PATH": "/usr/local/go/bin:/Users/you/go/bin:${PATH}"}（Windows 用分号和正斜杠）
LSP-Go 必须硬编码 gopls 绝对路径
LSP 插件默认只查 $PATH，但 GUI 启动方式常导致该变量不可用。不硬编码，gopls 就起不来，所有语言功能直接瘫痪。
- 安装
LSP和LSP-Go插件（别装GoSublime，它和gopls冲突） - 打开
Preferences → Package Settings → LSP → Settings - 在
"clients"下添加完整配置，关键点是"command"必须为绝对路径：{ "clients": { "gopls": { "command": ["/Users/you/go/bin/gopls"], "enabled": true, "settings": { "gopls.build.experimentalWorkspaceModule": true, "gopls.formatting.gofumpt": true } } } } - Windows 路径用正斜杠：
"command": ["C:/Users/you/go/bin/gopls.exe"] -
"gopls.build.experimentalWorkspaceModule": true是 Go 1.21+ 必需项，否则即使有go.mod，gopls也加载失败
项目根目录没有 go.mod，gopls 功能全失效
gopls 依赖 module 模式识别包结构。没有 go.mod，跳转定义、补全 import、类型推导全部失灵——不是插件没装好，是项目本身不被识别为 Go 模块。
- 确保当前文件位于项目根目录，且该目录下有
go.mod - 没有？在终端进项目根目录，执行
go mod init example.com/foo（域名随便填，只是占位） - 构建系统中务必设
"working_dir": "${file_path}"，否则go run .会找不到模块 - 如果项目含
go.work（多模块工作区），gopls也能识别，但要求gopls≥ v0.13.3
保存时格式化冲突：别混用 gofmt、goimports 和 gopls
多个格式化工具同时启用，光标乱跳、缩进错乱、import 被反复增删，根本原因是行为没收口。
- 关掉所有其他格式化插件：
GoFormat、GoSublime的fmt_enabled、GoImports插件 - 让
gopls统一处理：它原生支持goimports行为（自动增删 import），也兼容gofumpt风格（需配置"formatting.gofumpt": true） - 检查
LSP设置里是否启用了"format_on_save"（默认开启），别在别的地方再配一遍 - 若想保留手写格式（比如长行不拆），在
gopls设置里加"formatting.gofmtSimplify": false
go 和 gopls 的路径是否被 Sublime 真正看见、go.mod 是否真实存在、gopls 配置是否匹配当前 Go 版本——这三处任一出错，整个语言功能就静默失效，没有任何明显报错。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
