GoSublime在Sublime Text 4和Go 1.21+下基本不可用，不推荐新项目使用；它依赖弃用的gocode和旧go get流程，不识别go.mod，导致补全失效、跳转报错、格式化静默失败；唯一可靠方案是LSP+LSP-Go插件配合手动安装gopls及项目含go.mod。
GoSublime 在 Sublime Text 4 和 Go 1.21+ 环境下基本不可用，不推荐新项目使用。它依赖已弃用的 gocode 和旧版 go get 流程，无法识别 go.mod，导致补全失效、跳转报 “no package found”、保存格式化静默失败。真正能跑通的路径只有一条：LSP + LSP-Go 插件 + 手动安装 gopls + 项目含 go.mod
Sublime 启动后根本找不到 GoSublime？
这是最常被忽略的硬性前提：GoSublime 在 Sublime Text 4 上默认不加载（Package Control 安装后显示灰色禁用），在 ST3 Build 3143+ 上也频繁与 gopls 冲突。
- 检查 Sublime 版本：菜单 → Help → About，确认不是 ST4；ST4 用户请直接跳过
GoSublime，改用LSP+LSP-Go - ST3 用户若看到状态栏左下角无
Go (GOPATH=...)提示，说明插件未激活——别反复重装，先看下一步 -
GoSublime要求显式配置GOPATH，且路径不能含中文或空格；Windows 用户注意用正斜杠或双反斜杠，例如"GOPATH": "C:/Users/name/go"
gopls 装了但 LSP-Go 卡在 “starting…”？
这不是插件故障，是 gopls 在首次索引项目依赖。小项目等 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
Sublime 找不到 go 或 gopls 命令？
GUI 启动的 Sublime（Dock / 开始菜单）不继承 shell 的 PATH，即使终端里 which go 正常，Sublime 里仍会报 command not found。
立即学习“go语言免费学习笔记（深入）”；
- 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）或"env": {"PATH": "C:\Go\bin;C:\Users\you\go\bin;%PATH%"}（Windows）
保存时格式化失效，或代码被意外重排？
混用 gofmt、goimports 和 gopls 格式化会导致冲突，光标乱跳、缩进错乱。
- 关掉所有其他格式化插件（如
GoFormat、GoSublime的fmt_enabled） - 让格式化行为收口到
gopls：确保LSP-Go配置中启用了format_on_save，并在gopls的settings.json里设"formatting.gofumpt": true（如需严格风格） - 若坚持用本地命令，只配
"fmt_cmd": ["gofmt", "-s"]，去掉-w（由插件自行处理写入）
真正卡住的地方往往不是插件装没装，而是 go.mod 有没有、PATH 继承对不对、gopls 版本够不够新——这三处漏掉任一，整个流程就会静默失败。
