subl 命令未装好表现为终端执行 subl --help 报 command not found；macos 默认不注册该命令，需手动配置软链或通过 homebrew 安装自动创建 /usr/local/bin/subl 或 /opt/homebrew/bin/subl。
subl 命令根本没装好，怎么确认？
直接在终端输 subl --help，如果报 command not found 或 'subl' is not recognized，说明命令压根没注册进 shell。这不是 Sublime 的问题，是安装时漏了 CLI 工具配置。
macOS/Linux 用户检查 /usr/local/bin/subl 是否存在；Windows 用户检查 C:Users{user}AppDataLocalSublime TextBuild XXXXsubl.exe 是否被加进系统 PATH（不是用户 PATH）。
- macOS 安装后默认不创建
subl，需手动运行菜单里的 Sublime Text → Install Shell Commands - Windows 安装时勾选 “Add to PATH” 才有
subl；若已安装但没勾，重装或手动把安装目录加进系统环境变量 - Linux（如 Deb/RPM 包）通常自带
subl，但 Snap/Flatpak 版本默认不提供，得用sudo snap alias sublime-text subl显式设置
subl 能运行但 Sublime 看不到你的 PATH，怎么办？
这是最常被误判的点：终端里 echo $PATH 有 /opt/homebrew/bin，可 Sublime 里 os.environ.get('PATH') 却为空——因为 GUI 应用（双击启动的 Sublime）不加载 shell 初始化文件（.zshrc、.bash_profile），subl 启动它时也只继承当前终端的环境，不是“全局 PATH”。
验证方式只有一种：必须从同一终端启动 Sublime，再查环境：
- 终端执行
which python记下路径（比如/opt/homebrew/bin/python3） - 在同一终端执行
subl .（注意是subl .，不是subl单独开窗口） - 在 Sublime 中按
Ctrl+`，输入import os; print(os.environ.get('PATH'))，确认输出中包含上一步的路径
如果没出现，说明 subl 启动的 Sublime 没拿到你预期的环境，别调构建系统或 linter，先回头检查 shell 配置是否漏 source ~/.zshrc 或 Windows 的 PATH 是否写错层级。
subl 启动后构建系统仍报 “Unable to find command”
错误信息里的 Unable to find command 不是指 subl，而是构建系统 "cmd" 数组第一项（如 "python"、"eslint"）找不到——Sublime 不会自动从你终端的 PATH 里搜，它只认自己启动时继承到的那串 PATH。
关键看构建系统文件里 "cmd" 怎么写的：
-
["python", "-u", "$file"]→ 依赖 PATH，必须确保subl是从正确环境启动的 -
["/opt/homebrew/bin/python3", "-u", "$file"]→ 绕过 PATH，但路径必须绝对准确，空格路径（如C:Program Files）要用双反斜杠C:\Program Files\Python39\python.exe -
["node", "script.js"]→ 若node在/opt/homebrew/bin，而该路径不在 Sublime 的PATH里，就必然失败
Windows 下尤其注意：where eslint 返回的是 eslint.cmd，但 Sublime 构建系统里填 eslint 就行，不用加 .cmd 后缀；路径中不能包裹引号，否则整个字符串被当做一个命令名去查找。
怎么快速判断 subl 配置是否真生效？
别靠“能打开窗口”来判断。真正生效的标准只有一条：从终端运行 subl . 后，Sublime 内部能调通你项目依赖的所有 CLI 工具（python --version、eslint --version、tsc --version）。
实操三步闭环验证：
- 终端执行
subl .（确保当前目录是你的项目根） - 在 Sublime 中新建一个
test.py，内容为import os; print(os.environ.get('PATH')) - 按
Ctrl+B运行，看输出是否含你期望的 bin 目录；再新建test.sh，内容为#!/bin/bash eslint --version，保存后同样Ctrl+B，看是否输出版本号
只要第二步的 PATH 对，第三步的命令基本不会挂——所有“插件不工作”的问题，80% 都卡在这第一步的 subl 启动方式上。路径写死虽绕过环境问题，但换机器就得改配置；依赖 PATH 更灵活，代价是必须管好 subl 的启动源头。
