不推荐新项目使用gosublime；应改用lsp+lsp-go插件，配合手动安装gopls和go.mod。因其依赖弃用的gocode和旧go get流程，不支持go 1.16+模块模式，导致补全、跳转、格式化等功能失效。
GoSublime 已停止维护，2021 年后无实质更新，**不推荐新项目使用**；它在 Sublime Text 4 上基本不可用，在 ST3（Build 3143+）上也常与 Go 1.21+ 和 gopls 冲突。真正能跑通的路径只有一条：**用 LSP + LSP-Go 插件，配合手动装好 gopls 和 go.mod**。
为什么 GoSublime 现在大概率失败？
它依赖早已弃用的 gocode 和旧版 go get 流程，而现代 Go（1.16+）强制启用 module 模式，GoSublime 默认不识别 go.mod，导致补全失效、跳转报 “no package found”、保存格式化静默失败。
- 终端里
go version输出是go1.21.x或更高 →GoSublime几乎必然报gopls not found或卡在 “loading…” - 你用的是 Sublime Text 4 →
GoSublime插件根本不会加载（Package Control 会安装失败或显示灰色禁用） - 配置里写了
"fmt_cmd": ["goimports"]，但没运行过go install golang.org/x/tools/cmd/goimports@latest→ 保存时直接无反应，连错误都不报
gopls 装了但 Sublime 启动后不工作？检查 PATH 继承
Sublime Text GUI 启动（Dock / 开始菜单）不继承 shell 的 PATH，即使终端里 which go 和 which gopls 都有输出，Sublime 里仍会提示 command not found。
- macOS：别只改
~/.zshrc，还得执行launchctl setenv PATH "/opt/homebrew/bin:/usr/local/go/bin:$PATH"（按which go实际路径调整），然后重启 Dock - Windows：把
C:Goin和%USERPROFILE%goin都加进「系统环境变量」PATH（不是用户变量），并确认 Sublime 不是以兼容模式运行 - 通用兜底：在 Sublime → Preferences → Settings – User 中加
"env": {"PATH": "/usr/local/go/bin:/Users/you/go/bin:${PATH}"}（macOS/Linux）或"PATH": "C:\Go\bin;C:\Users\you\go\bin;%PATH%"（Windows，注意双反斜杠）
LSP-Go 插件启动卡在 “starting…” 怎么办？
这不是插件坏了，是 gopls 在首次索引你的项目依赖——尤其当 go.mod 里有大量第三方包时，可能卡住 10–30 秒。但如果超过 1 分钟还停在那儿，就得排查硬伤：
- 项目根目录没有
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 - 缓存损坏 → 删除
~/Library/Caches/gopls（macOS）或%LOCALAPPDATA%gopls（Windows）
保存自动格式化乱跳、import 被删光、光标错位？
这是多个格式化工具打架的典型症状：你同时开了 GoSublime 的 fmt_on_save、LSP-Go 的 format_on_save，还手动绑了 goimports。结果 gopls 格式一遍，goimports 又扫一遍，最后 gofmt 再压一遍。
- 立刻关掉所有其他格式化插件：在 Package Settings 里禁用
GoSublime、GoFormat、GoImports - 只留
LSP-Go，并在其设置中明确指定："settings": {"gopls": {"formatting.gofumpt": true}}（启用更严格的风格） - 确保没有自定义
.sublime-build文件里写了"cmd": ["goimports", "-w"]—— 构建系统不该干格式化的活
gopls 是 Go 官方语言服务器，它不靠插件“猜”代码，而是读 go.mod 解析整个模块依赖图。这意味着：**没 go.mod，就等于没 Go 环境**——哪怕 go run main.go 能跑，LSP 功能也全废。别省那一步 go mod init。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
