Sublime Text 中 Go 开发问题主因是工具链未正确配置：gopls 未启动、go/gopls/golangci-lint 不在 PATH、启动方式导致环境变量丢失、格式化冲突或模块路径错误；需通过终端验证路径、用 subl 启动、正确安装 gopls、显式配置 linter 路径、统一由 gopls 处理格式化，并确保 go.mod/go.work 正确。
Go build命令不执行，gopls 启动失败
Sublime Text 本身不运行 Go，它靠外部工具链干活。如果保存后没报错也没构建结果，大概率是 gopls 没起来，或者 go 命令根本不在 $PATH 里。
检查方法：终端敲 which go 和 which gopls，两个都得有输出。macOS 或 Linux 用户尤其注意 Sublime Text 启动方式——从 Dock 或 Spotlight 启的，往往不继承 shell 的 $PATH，得改用 subl 命令从终端启动。
- Windows 用户确认
go.exe和gopls.exe在系统环境变量PATH中，别只配在用户变量里 - macOS 用户如果用 zsh，把
export PATH=$PATH:/usr/local/go/bin加到~/.zshrc，然后运行source ~/.zshrc && subl - 装
gopls别用go get（已弃用），改用go install golang.org/x/tools/gopls@latest
SublimeLinter-golangci-lint 报 command not found
这是插件找不到 golangci-lint 二进制文件的典型表现。和 gopls 类似，它不随 Go 安装，必须单独下载，且路径要对得上。
插件默认只查 $PATH，但很多用户把 golangci-lint 下载到 ~/bin 或 ~/go/bin，这些路径未必被 Sublime 继承。
立即学习“go语言免费学习笔记（深入）”；
- 运行
which golangci-lint确认位置，比如输出是/Users/you/go/bin/golangci-lint - 在 Sublime 的
Preferences → Package Settings → SublimeLinter → Settings里，加这一段：
"linters": {
"golangci_lint": {
"executable": ["/Users/you/go/bin/golangci-lint"]
}
}
- 别漏掉方括号——SublimeLinter 要的是数组，不是字符串
- Windows 路径用正斜杠或双反斜杠，比如
["C:/Users/you/go/bin/golangci-lint.exe"]
保存时自动格式化失效，gofmt 和 goimports 混用冲突
Go 社区现在主推 gofumpt 或直接由 gopls 处理格式化，但老教程常教配 GoSublime 或手动绑 gofmt。问题在于：如果同时启用了 gopls 的 format on save 和本地 gofmt 命令，二者可能打架，光标乱跳、缩进错乱。
正确做法是让所有格式化行为收口到 gopls ——它支持 goimports 行为（自动增删 import），也兼容 gofumpt 风格（需配置）。
- 关掉其他格式化插件，比如
GoFormat或GoSublime的 format 功能 - 确保
gopls配置里开了"formatting.gofumpt": true（如需严格风格） - 在 Sublime 的 LSP 设置中确认
"enabled": true且"initializationOptions"包含格式化开关
跳转定义（Go to Definition）卡住或跳错
这不是 Sublime 的问题，是 gopls 对模块路径和工作区的理解偏差。常见于项目没开 Go modules、或 go.work / go.mod 位置不对。
gopls 必须知道当前文件属于哪个 module，否则它按 GOPATH 模式瞎猜，跨目录跳转就失效。
- 根目录必须有
go.mod，且module声明与实际路径一致（比如module example.com/foo，那项目就得放在$GOPATH/src/example.com/foo或任意位置但用go work use关联） - 多模块项目务必用
go work init+go work use ./xxx生成go.work，再重启gopls - Sublime 里右键菜单的
Go to Definition实际调的是 LSP，所以先看状态栏左下角有没有显示gopls ready，没这个就别试跳转
最麻烦的其实是 vendor 模式和 replace 指令混用——gopls 对这两者解析不稳定，能不用尽量不用。
