Sublime Text 中 Go 无法运行的主因是 go 命令未被识别且项目缺少 go.mod；需手动配置完整路径或环境变量，确保 gopls 正确安装并启用 experimentalWorkspaceModule，禁用冲突格式化工具，添加 show_panel_on_build 以查看错误。
Sublime Text 里跑不起来 Go，90% 是因为 go 命令根本没被它看见——不是插件装得少，是环境变量没传进去；Go 1.21+ 项目必须有 go.mod，否则 gopls 直接拒绝工作。
Go 命令在 Sublime 里报 exec: "go": executable file not found
这不是 Sublime 没装好，是它启动时压根没拿到你 shell 里配好的 PATH。macOS GUI 启动（Dock/Spotlight）、Windows 从开始菜单点开，都会丢掉 go 路径。
- 先在终端运行
which go，记下输出，比如/usr/local/go/bin/go或C:Goingo.exe - macOS：编辑
~/Library/Application Support/Sublime Text/Packages/User/Go.sublime-build，把"cmd": ["go", "run", "$file"]改成"cmd": ["/usr/local/go/bin/go", "run", "$file"] - Windows：确认
C:Goin已加进「系统环境变量」PATH（不是仅用户变量），且 Sublime 没勾选“以兼容模式运行” - 通用兜底：在 Sublime 的
Preferences → Settings – User里加"env": {"PATH": "/usr/local/go/bin:${PATH}"}（macOS/Linux）或"env": {"PATH": "C:\Go\bin;%PATH%"}（Windows）
跳转定义（Goto Definition）失效或跳到空文件
这基本等于 gopls 没跑起来，或者跑起来了但找不到项目上下文。GoSublime 已淘汰，现在全靠 gopls 提供语义能力。
- 确保项目根目录有
go.mod：终端进项目目录，执行go mod init example.com/foo - 安装并验证
gopls：go install golang.org/x/tools/gopls@latest，然后gopls version必须 ≥ v0.14.0 - 用 LSP + LSP-Go 插件（别碰 GoSublime），在
Preferences → Package Settings → LSP → Settings里硬编码路径："command": ["/Users/you/go/bin/gopls"]（macOS）或"command": ["C:/Users/you/go/bin/gopls.exe"]（Windows） - 必须开启
"gopls.build.experimentalWorkspaceModule": true，Go 1.21+ 不开这个，gopls就不认go.mod
保存后代码被意外重排，import 自动增删失控
问题不在格式化本身，而在多个格式化工具打架：gofmt、goimports、gopls 同时响应保存事件，谁快谁写，结果就是缩进错乱、行被拆散、手动调好的布局全毁。
立即学习“go语言免费学习笔记（深入）”；
- 关掉所有其他格式化插件（如 GoFormat、GoSublime 的 format 功能），只留
gopls一个出口 - 在
gopls配置里设"formatting.gofumpt": true（需提前go install mvdan.cc/gofumpt@latest），它比原生gofmt更稳定 - 如果只想严格保持手写结构，禁用自动格式化：LSP 设置里删掉
"format_on_save"，改用手动触发ctrl+shift+p → LSP: Format Document - 别在插件设置里写
"on_save": {"enabled": true, "commands": ["goimports"]}—— 这是老教程的坑，goimports现在由gopls内建支持
构建后输出面板一闪而过，看不到错误信息
默认 exec 构建目标会在命令退出后立刻关闭输出面板，尤其编译失败时，错误堆栈根本来不及看。
- 打开
Go.sublime-build文件，在 JSON 里加上这两行："show_panel_on_build": true和"quiet": false - 别用
"cmd": ["go", "run", "$file_name"]——$file_name不带路径，go run会因找不到依赖包报no Go files in current directory，统一用$file - 确保
"working_dir": "${file_path}"，且当前文件位于含go.mod的目录下，否则go run .会失败
最易被忽略的点：gopls 首次索引项目可能卡住 30 秒以上，别急着关掉；如果超 1 分钟没反应，先检查 go.mod 是否存在、GOPATH 路径是否含中文或空格——这两个问题会导致 gopls 启动直接崩溃，连日志都不打。
