GoSublime 已停止维护，不兼容 Go 1.21+ 和 Sublime Text 4，补全失效、跳转错乱、格式化失败频发；需手动修复 PATH 继承、禁用 GOPATH 自动推断、强制使用 gopls 并配置 go.mod，但架构不兼容问题无法根治。
GoSublime 已停止维护，新项目别用；它在 Go 1.21+ 和 Sublime Text 4 下基本不可用，补全失效、跳转错乱、保存格式化静默失败是常态。真要跑通，必须绕开三个硬坑：PATH 不继承、GOPATH 自动推断失效、gopls 不识别。
Sublime 启动后根本找不到 go 或 gopls 命令
GUI 启动的 Sublime（Dock / 开始菜单）不继承 shell 的 PATH，哪怕终端里 which go 和 which gopls 都正常，插件内部仍会报 command not found: go 或 gopls not found。
- macOS：执行
launchctl setenv PATH "/usr/local/go/bin:/Users/you/go/bin:$PATH"（按实际路径替换），然后重启 Dock（killall Dock） - Windows：把
C:\Go\bin和C:\Users\you\go\bin加进「系统环境变量」PATH（不是用户变量），并确认 Sublime 没勾选兼容模式 - 通用兜底：打开 Sublime → Preferences → Settings – User，加这段（注意双反斜杠或正斜杠）：
{"env": {"PATH": "/usr/local/go/bin:/Users/you/go/bin:${PATH}"}}或{"env": {"PATH": "C:/Go/bin;C:/Users/you/go/bin;%PATH%"}} - 改完必须重启 Sublime —— 重载设置或刷新插件无效
GoSublime 装了但状态栏没显示 Go (GOPATH=...) 提示
这说明插件没激活，不是安装失败，而是默认行为和现代 Go 项目冲突：它强行读取 $GOPATH，而 Go 1.11+ 后 go.mod 才是项目根，$GOPATH 已退居次要地位。
- 打开 Preferences → Package Settings → GoSublime → Settings – User，写入最小配置（关键禁用自动推断）：
{"env": {"GOROOT": "/usr/local/go", "GOPATH": "/Users/you/go"}, "fmt_enabled": false, "autocomplete_builtins": true} - Windows 用户路径用正斜杠：
"GOROOT": "C:/Go"、"GOPATH": "C:/Users/you/go" - GOPATH 路径不能含中文、空格或符号（如
C:\Users\张三\go会导致 gopls 直接崩溃） - ST4 用户请直接跳过——GoSublime 在 ST4 上默认灰色禁用，不加载
补全失效、跳转报 “no package found”、保存后代码被意外重排
根本原因是 GoSublime 默认调用已弃用的 gocode，又试图桥接 gopls，但不识别 go.mod，也不处理 module-aware 行为。
- 手动安装最新
gopls：go install golang.org/x/tools/gopls@latest（不是go get） - 运行
gopls version确认输出 ≥v0.14.0；旧版对 module 支持极差 - 项目根目录必须有
go.mod文件，没有就进目录执行：go mod init example.com/foo - 禁用 GoSublime 自带的格式化（
"fmt_enabled": false），否则它可能和goimports冲突，把一行 import 拆成多行 - 如果坚持用
goimports，确保只配"fmt_cmd": ["goimports"]，别混用gofmt -s
语法高亮不生效或提示全是白底黑字
GoSublime 不会自动把 .go 文件绑定到 Go 语法，这是最常被忽略的“一步到位”操作。
- 打开任意
main.go文件 → 点右下角当前语法标识（比如显示 “Plain Text”）→ 选择Go（不是GoSublime或Go Build） - 如果列表里没有
Go，说明 GoSublime 没装成功，检查 Package Control 控制台是否报ImportError: No module named 'go' - 别选
GoSublime Syntax—— 这是旧版遗留项，已弃用，会导致高亮错乱 - 高亮样式依赖当前主题，若仍不明显，临时切到
Monokai主题验证是否为配色问题
真正稳定的方案是 LSP + LSP-Go + gopls，GoSublime 只适合维护老项目或有强习惯依赖；哪怕按上述步骤全做对，它在 Go 1.21+ 下依然可能随机丢补全、跳错定义——这不是配置问题，是架构层面的不兼容。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
