应直接使用LSP+gopls+正确构建系统，禁用GoSublime；需配置Sublime的PATH环境变量、确保项目含go.mod、用原生Go语法高亮，并设置build系统为"go run ."且启用shell:true。
Sublime 本身不运行 Go，它只是调用系统 go 命令；真正卡住的几乎全是环境路径没通、构建目录不对、或用了已停更插件导致功能静默失效。别折腾 GoSublime，直接走 LSP + gopls + 正确构建系统这一条路。
Sublime 找不到 go 或 gopls 命令？PATH 没继承是主因
GUI 启动的 Sublime（Dock / 开始菜单）完全不读 shell 的 PATH，哪怕终端里 go version 和 gopls version 都正常，Sublime 内部仍会报 command not found。
- 先在终端执行
which go（macOS/Linux）或where go（Windows），记下完整路径，例如/usr/local/go/bin/go或C:/Go/bin/go.exe - 打开 Sublime → Preferences → Settings – User，添加或修改
"env"字段：{ "env": { "PATH":"/usr/local/go/bin:/Users/you/go/bin:${PATH}" } }Windows 用户写成：{ "env": { "PATH":"C:/Go/bin;C:/Users/you/go/bin;${PATH}" } } - 改完必须重启 Sublime —— 热重载或重载设置无效
构建系统用 go run . 而不是 go run $file
单文件 $file 模式只适用于玩具代码；真实项目含多文件、依赖、go.mod，必须让 go 在模块根目录执行。
- Tools → Build System → New Build System，粘贴以下内容并保存为
GoRun.sublime-build：{ "cmd": ["go", "run", "."], "working_dir": "${file_path}", "shell": true, "selector": "source.go" } -
"shell": true是关键：它通过系统 shell 执行命令，才能读取你 shell 里设的GO111MODULE=on、GOPATH等变量 - 确保当前打开的文件位于含
go.mod的目录下；否则go run .会报no Go files in current directory
LSP-Go 卡在 “starting…”？不是插件坏了，是 gopls 没过三关
gopls 启动慢是常态，但卡死超过 60 秒，基本是下面三个硬伤之一：
Alibabacloud Sdk Client Initialization For Golang
下载
初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。
立即学习“go语言免费学习笔记（深入）”；
- 项目根目录没有
go.mod→ 终端进项目目录，运行go mod init example.com/foo -
go env GOPATH输出含中文或空格（如C:/Users/张三/go）→gopls直接崩溃，必须换纯英文路径 -
gopls版本太老 → 运行go install golang.org/x/tools/gopls@latest，再执行gopls version确认输出 ≥v0.14.0
语法高亮和补全失效？别选 GoSublime Syntax，用原生 Go
右下角显示 “Plain Text” 或 “GoSublime Syntax” 就是错的 —— Sublime 自带的 Go 语法才正统，GoSublime Syntax 是旧版遗留项，会导致注释高亮错乱、字符串解析异常。
- 打开任意
.go文件 → 点右下角当前语法名 → 从列表中选Go（不是GoSublime，也不是Go Build） - 补全是否生效，取决于
gopls是否连上：看状态栏左下角是否显示gopls；没显示说明 PATH 或go.mod位置仍有问题 - 如果用了
go run .但报main redeclared，说明当前目录下有多个main函数文件，删掉冗余的或拆到子包
最常被忽略的是：Sublime Text 4 上 GoSublime 插件根本不会加载，且 gopls 对 go.mod 位置极其敏感 —— 它只认当前打开文件向上遍历第一个找到的 go.mod，而不是你心里认为的“项目根”。
