sublime构建系统可调用任意命令行可执行工具，关键在于能否终端单行运行；需用绝对路径、cmd数组格式传参，shell_cmd用于管道等shell特性；selector决定触发时机，quiet设为false便于调试。
构建系统能调用哪些自定义工具
只要工具是命令行可执行的，Sublime 就能调用：Python 脚本、Shell/Batch 脚本、Go 编译后的二进制、Node.js CLI 工具（如 prettier）、甚至你写的 Rust 小工具。关键不是“多高级”，而是它能否在终端里敲一行命令就跑起来——比如 mytool --input "$file" 能直接执行，那它就能进 .sublime-build。
注意两点：
- Windows 下若工具路径含空格（如
C:My Toolschecker.exe），必须用双引号包裹，并在 JSON 中写成双反斜杠："C:\My Tools\checker.exe" - 不要依赖当前终端的 PATH；Sublime 启动方式不同（开始菜单 vs
subl .），PATH 可能不一致；最稳的是写绝对路径
cmd 数组写法错误导致静默失败
常见错误是把命令写成字符串："cmd": "python mytool.py $file"——这会完全失效，Ctrl+B 没反应也没报错。Sublime 的 cmd 字段只接受数组，每个参数单独一项：
{
"cmd": ["python", "D:\tools\myrunner.py", "$file"],
"selector": "source.python",
"working_dir": "$file_path"
}
这样写才能正确传参。如果命令需要 shell 特性（比如管道 |、重定向 2>&1、条件执行 &&），就不能用 cmd，得换 shell_cmd 并设 "shell": true：
{
"shell_cmd": "python "D:\tools\myrunner.py" "$file" 2>&1",
"shell": true,
"selector": "source.python"
}
注意：shell_cmd 是字符串，变量要用 "$file"（带引号），且 Windows 下路径空格必须转义。
如何让构建系统识别你的工具文件类型
没设或写错 selector，就算配置保存成功，Ctrl+B 也不会触发——哪怕它出现在 Tools → Build System 菜单里。
查当前文件的语法范围：按 Ctrl+Shift+P → 输入 show scope 回车，看输出里类似 source.python 或 source.shell 的字段。然后照抄进配置：
- Python 文件：
"selector": "source.python" - Bash 脚本：
"selector": "source.shell" - 任意后缀为
.check的文件（假设你工具专处理它）："selector": "source.check"，再配合自定义语法高亮（另配.sublime-syntax）
别写 "selector": "text.plain" 试图“兜底”——它太宽泛，容易被其他构建系统抢优先级；真要万能适配，用 "selector": "source | text"，但需在脚本里自行判断后缀。
调试时看不到错误？关掉 quiet 就行
默认 "quiet": true 会隐藏真实命令和 stderr 输出，你只看到 [Finished in 0.02s]，根本不知道工具是否启动、参数对不对、为什么退出码是 1。
加这一行立刻暴露问题：
"quiet": false
输出面板会显示完整执行命令，例如：
cd /path/to/file && python "D: oolsmyrunner.py" "C:proj est.py" [Errno 2] No such file or directory: 'D:\tools\myrunner.py'
这时你就知道是路径错了。另外注意：$file 变量只在文件已保存时才展开；未命名的 Untitled 标签页里它是空字符串，命令变成 python mytool.py ""，大概率报错。
真正难搞的点往往不在配置语法，而在于工具本身是否能在 Sublime 继承的最小环境里跑通——比如缺 DLL、权限不足、或依赖终端交互（input() 类操作在构建系统里会卡住）。先确保它在 CMD/PowerShell 里不加任何参数也能 echo 出 hello，再往 Sublime 里搬。
