GoSublime已停更，2026年起不推荐用于新项目；它依赖弃用的gocode，不识别go.mod，导致补全、跳转、格式化失效，且在Sublime Text 4中默认禁用，必须手动配置gopls路径并禁用旧工具链才能勉强运行。
GoSublime 已停更，2026 年起不推荐用于新项目；它默认调用已淘汰的 gocode，与 go mod 项目不兼容，补全、跳转、格式化大概率失效——这不是你配错了，是它根本没设计支持现代 Go。
为什么 GoSublime 在 Sublime Text 4 和 Go 1.21+ 下基本不可用
它依赖的 gocode 自 2021 年起被官方弃用，guru 和 oracle 工具也早已下线；而 GoSublime 没有适配 gopls 的自动 fallback 机制，也不会识别 go.mod，导致：
- 状态栏显示
Go (GOPATH=)却无法补全任何包名（因为没 module 上下文） - 按
F12跳转提示no package found（gopls没启动，gocode又跑不起来） - 保存后 import 行反复增删、结构重排（
gofmt和gopls格式化打架） - 插件在 Sublime Text 4 中默认灰色禁用，Package Control 安装后也不加载
GoSublime Settings – User 必须改的三项
如果你仍在 ST3 且必须用 GoSublime（例如维护老项目），需手动切断旧链路、显式接入 gopls：
- 删掉或注释所有含
"gocode"、"guru"、"oracle"的配置项 - 加
"use_go_tooling": false（否则它会自己拉旧版工具并静默失败） - 显式指定
"gopls_path"：macOS/Linux 填"/Users/you/go/bin/gopls"，Windows 填"C:/Users/you/go/bin/gopls.exe"（路径必须真实存在，用which gopls或where gopls验证）
改完保存，重启 Sublime Text —— 此时补全和跳转才可能由 gopls 实际提供，而非假死的 gocode。
立即学习“go语言免费学习笔记（深入）”；
fmt_cmd 和 gopls 格式化冲突怎么破
GoSublime 默认启用 on_save 格式化，但若同时运行 gopls（比如你装了 SublimeLSP），两者会抢着改文件，造成光标乱跳、import 被反复清理。
- 把
"fmt_cmd"设为空数组："fmt_cmd": [] - 关掉
GoSublime的保存触发："on_save": {"enabled": false} - 确保
gopls是唯一格式化源：检查~/.config/gopls/settings.json是否含"formatting.gofumpt": true（如需严格风格）或至少"formatting.gofmtSimplify": false（防自动简化破坏手写布局）
别再装 GoImports 或 GoFormat 这类独立插件——它们和 GoSublime 的 fmt_cmd 逻辑重叠，只会让问题更难定位。
exec: "go": executable file not found 的真实原因
这不是 Go 没装，是 Sublime Text 启动时压根没拿到你的 $PATH。macOS 从 Dock 点开、Windows 从开始菜单启动时，GUI 进程完全不继承 shell 环境变量。
- macOS：终端执行
launchctl setenv PATH "$(which go | xargs dirname):$(which gopls | xargs dirname):$PATH"，再killall 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）
验证方式：按 Ctrl+` 打开 Sublime 控制台，输入 import os; print(os.environ.get('PATH'))，看输出是否含 go 和 gopls 路径。
真正麻烦的不是哪一步配错，而是 GoSublime 把构建、LSP、格式化全塞在一个插件里，每个环节都得手动切离——它不是“轻量替代”，而是“历史包袱”。如果你只是写小工具或读代码，LSP + LSP-Go + 硬编码 gopls_path 更干净。
