根本原因是GUI启动的Sublime未继承shell的PATH环境变量，需先终端验证g++ --version，再按系统差异配置MinGW-w64、Homebrew gcc或build-essential，并确保构建系统使用shell_cmd支持&&链式执行。
subl 命令失效、插件找不到 go 或 gopls、构建系统报 gcc 不是内部命令——这些问题的根因几乎全是 PATH 没传进 Sublime 进程，而不是你没装对工具。
Windows 下 subl 命令不生效：先确认 subl.exe 存在，再配 PATH
官方安装包自带 subl.exe，但绿色版、便携版、第三方打包版通常没有它。别急着改环境变量，先手动验证：
- 打开 Sublime 安装目录（默认是
C:\Program Files\Sublime Text或C:\Users\）\AppData\Local\Programs\Sublime Text - 找有没有
subl.exe（和sublime_text.exe同级） - 没有就重装官网正版；有，再继续
PATH 配置要点：
- 必须把 安装目录本身 加进系统 PATH（不是子目录，比如别加
...\Sublime Text\sublime_text.exe） - 安装时勾选 “Add to PATH” 仅对 Win10/11 新版安装器有效；旧版或解压安装不会触发
- 改完 PATH 后，所有 CMD/PowerShell 窗口必须关闭重开——旧窗口不会自动 reload
- 用 Windows Terminal 或 ConEmu？得重启整个终端程序，不只是新建标签页
- 某些企业策略或杀软会静默拦截 PATH 修改，此时即使路径正确也执行失败
macOS/Linux 下 subl 命令不可用：靠 shell 初始化文件加载，不是 GUI PATH
macOS 和 Linux 没有全局 GUI 级 PATH。只改 /etc/environment 或图形设置里的 PATH 是无效的。
必须写进当前 shell 的初始化文件：
- macOS Catalina 及之后默认用 zsh → 编辑
~/.zshrc，加一行：export PATH="/Applications/Sublime Text.app/Contents/SharedSupport/bin:$PATH" - bash 用户 → 改
~/.bash_profile或~/.bashrc - 改完必须运行
source ~/.zshrc（或对应文件），否则不生效 - GNOME/KDE 桌面下，GUI 应用（包括从 Dock 启动的 Sublime）可能仍不识别新 PATH，需注销重登录
替代方案（更可靠）：
- macOS：用
sudo ln -s "/Applications/Sublime Text.app/Contents/SharedSupport/bin/subl" /usr/local/bin/subl（注意路径含空格要加引号） - Linux：推荐用 tarball 版解压安装，然后
sudo ln -s /path/to/sublime_text /usr/local/bin/subl
Sublime 内部找不到 go/gopls/gcc/python：GUI 启动不继承 shell PATH
你在终端里 which go 和 which gopls 都能返回路径，但 Sublime 里 LSP 插件或构建系统仍报 command not found——这是典型 GUI 启动未继承 shell 环境变量的表现。
解决路径分三层：
-
第一层（推荐）：确保 shell 初始化文件已正确配置并
source，且 Sublime 是从终端启动（subl .）。这样它直接继承当前 shell 的 PATH -
第二层（兜底）：打开 Sublime →
Preferences → Settings – User，硬编码 env："env": {"PATH": "/usr/local/go/bin:/Users/you/go/bin:/opt/homebrew/bin:$PATH"}（Windows 用分号，路径用正斜杠） -
第三层（LSP 必须）：LSP-Go 插件的
goplscommand 字段必须填绝对路径，不能依赖 PATH 查找；否则语言服务器根本起不来
构建系统同理："cmd": ["gcc", "-o", "$file_base_name", "$file"] 会失败，应改为："cmd": ["/usr/bin/gcc", "-o", "$file_base_name", "$file"]（先 which gcc 确认路径）
WSL、PowerShell、多 shell 共存时容易漏掉的点
这些场景下 PATH 容易“断层”：
- WSL 用户：Windows 的 PATH 不会自动透传，需在
~/.bashrc或~/.zshrc里显式加 Windows 路径，例如：export PATH="/mnt/c/Users/xxx/AppData/Local/Programs/Python/Python39:$PATH" - PowerShell 用户：
subl.bat对 PowerShell 无效；需单独设 alias：Set-Alias subl "C:\Program Files\Sublime Text\sublime_text.exe"，并加到$PROFILE - zsh 用户却在改
~/.bash_profile：macOS Catalina+ 默认用 zsh，改错文件等于白改 - 多个 shell（如 fish + zsh）共存：哪个是 login shell？用
echo $SHELL确认，只改那个 shell 的初始化文件
最常被忽略的是：Sublime 的 GUI 启动方式（双击图标、Spotlight、开始菜单）和终端启动方式走的是两套 PATH 加载逻辑，而绝大多数问题都出在前者——它根本不看你 shell 配置，除非你手动注入。
