subl命令根本不存在，需先安装命令行工具：macOS通过菜单栏Install Command Line Tool安装，Linux需手动建软链接，Windows须勾选Add to PATH或手动配置环境变量；验证用which subl或where subl及subl --version。
subl 命令根本不存在？先装命令行工具
很多人一上来就输 subl --version，结果报 command not found——这不是 PATH 没配对，而是压根没装这个工具。subl 不随 Sublime Text 自动安装，必须手动触发安装流程。
macOS 最稳妥方式：打开 Sublime Text → 菜单栏 Sublime Text → Install Command Line Tool。执行后，/usr/local/bin/subl 就有了，且自动处理空格和路径变更，比手动建软链接更可靠。
Linux（tarball 版）需手动建软链接：sudo ln -s /opt/sublime_text/subl /usr/local/bin/subl；Snap/Flatpak 版本默认不提供 subl，得换安装源或改用其他方式。
Windows 用户安装时务必勾选 Add to PATH；若漏选，要么把 C:\Program Files\Sublime Text\ 加进系统环境变量，要么在 C:\Windows\System32 下建 subl.bat（内容为 @start "" "C:\Program Files\Sublime Text\sublime_text.exe" %*）。
验证是否成功：which subl（macOS/Linux）或 where subl（Windows）有输出，再跑 subl --version 能返回版本号，才算真正可用。
构建系统调用 python/eslint/prettier 时找不到命令
Sublime 的构建系统（.sublime-build）默认不读你的 .zshrc 或 .bash_profile，它启动时只继承系统级环境变量，不会 source 你 shell 里 export 的 PATH。
所以你在终端里能跑 prettier --write test.js，但 Sublime 构建时报 command not found，很正常。
解决办法只有一个：用绝对路径。
- 先在终端运行
which prettier，得到类似/opt/homebrew/bin/prettier的路径 - 新建构建系统：
Tools → Build System → New Build System - 填入：
{ "cmd": ["/opt/homebrew/bin/prettier", "--write", "$file"], "selector": "source.js, source.jsx" } - 保存为
Prettier.sublime-build，右下角状态栏手动选中它
Windows 用户注意：cmd 数组里每个元素必须是独立字符串，路径用正斜杠 /，别写成 "C:\Users\...\prettier.cmd" 这种带反斜杠的字符串，会解析失败。
Python 构建系统中文乱码或输入卡死
直接用 python $file 运行含中文 print 或 input 的脚本，常出现乱码、闪退、或阻塞在输入等待——因为 Sublime 的构建面板不是完整终端，不支持交互式 stdin 流，也不自动设置编码。
关键参数只有两个：-u 和 PYTHONIOENCODING。
-
-u强制 Python 使用无缓冲输出，避免 print 内容滞留在缓冲区不显示 -
PYTHONIOENCODING=utf-8环境变量确保 IO 编码一致，防止中文乱码 - 构建配置示例（macOS/Linux）：
{ "cmd": ["python", "-u", "$file"], "env": {"PYTHONIOENCODING": "utf-8"}, "encoding": "utf-8", "selector": "source.python" } - Windows 用户建议用
python3而非python，避免系统自带旧版 Python 干扰
如果真需要交互输入（比如调试时 readline），别指望构建面板，改用外部终端：把 cmd 改成 ["open", "-a", "Terminal", "--args", "-c", "python -u '$file'; read -p 'Press Enter to continue...'"]（macOS）或类似方案。
为什么改了 .zshrc，Sublime 还是不认新 PATH
因为你点击 Dock 图标启动 Sublime，它根本没经过 shell 启动流程，.zshrc 里的 export PATH=... 对它完全无效。
哪怕你终端里 echo $PATH 看起来很完美，Sublime 启动时的 $PATH 可能还是系统默认那套（比如 /usr/bin:/bin:/usr/sbin:/sbin）。
所以所有依赖 PATH 的构建行为，都得绕过这个限制：
- 绝对路径是唯一稳解，别幻想“只要我 reload shell 就行”
- 不要在构建系统里写
"cmd": ["sh", "-c", "prettier --write $file"]—— sh 启动后依然不 source 你的配置文件 - Mac 用户可考虑用
launchctl setenv PATH ...注册全局环境变量，但重启后失效，实用性低
最省心的做法：把常用工具路径记下来，每次写构建系统时直接粘贴进去。习惯就好，别跟环境变量较劲。
