build system 文件必须放在 packages/user/ 目录下才生效；sublime text 仅加载该路径下的 .sublime-build 文件，其他位置均无视，且文件需以合法 json 格式保存、后缀正确、selector 匹配语法作用域。
Build System 文件必须放在 Packages/User/ 目录下才生效
Sublime Text 只加载 Packages/User/ 下的 .sublime-build 文件，其他位置（桌面、项目根目录、Packages/MyLang/）一概无视。打开 Preferences → Browse Packages…，直接进 User/ 子文件夹新建文件，命名如 MyDSL.sublime-build，后缀不能漏。
常见错误现象：改完配置按 Ctrl+B 没反应，菜单里也找不到新构建项——八成是文件放错了地方。别信“我双击打开了就生效”，Sublime 不扫描任意路径。
- Windows 路径示例：
C:Users ameAppDataRoamingSublime Text 3PackagesUser - macOS 路径示例：
~/Library/Application Support/Sublime Text 3/Packages/User/ - Linux 示例：
~/.config/sublime-text-3/Packages/User/
cmd 数组写法比 shell_cmd 更稳，尤其对非标准语言环境
非标准语言（比如自研 DSL、旧版 Tcl、Racket、Zig 等）往往依赖特定启动器、参数顺序或环境变量。用 shell_cmd 拼字符串容易因空格、引号、平台 shell 差异崩掉；cmd 是数组，Sublime 直接传参给 execve，不经过 shell 解析，更可控。
例如调用一个带空格路径的自定义解释器 C:ToolsMyLanginmylang.exe：
{
"cmd": ["C:\Tools\MyLang\bin\mylang.exe", "-r", "$file"],
"selector": "source.mylang",
"working_dir": "$file_path"
}
注意点：
- Windows 路径必须用双反斜杠
\或正斜杠/，且整个路径字符串加双引号 -
-r这类 flag 必须单独成数组元素，不能塞进路径字符串里 -
$file在cmd数组中自动展开为带引号的全路径（Windows 下），无需手动包裹
selector 匹配语法 scope，不是文件后缀
Sublime 不看 .dsl 后缀，而是看右下角显示的 syntax 名称（比如 “MyLang”）。如果文件是 .dsl 但显示 “Plain Text”，那 "selector": "source.mylang" 就永远不会触发。
查真实 scope 的方法：按 Ctrl+Shift+P → 输入 Developer: Show Scope Name，光标处会弹出类似 source.mylang meta.function.mylang 的输出。把最前面那个 source.mylang 填进 selector。
适配多个非标语法？别删 selector，用管道符：
"selector": "source.mylang | source.tcl | source.rkt"- 避免用
"source | text"——它会让构建项污染所有文件类型菜单
中文输出、交互输入、错误跳转这些细节最容易崩
非标准语言工具链常忽略编码约定，导致 Sublime 控制台乱码、input() 卡死、错误行号点不动。关键字段不是可有可无的装饰：
-
"encoding": "utf-8"：仅控制 Sublime 如何解码子进程 stdout/stderr 字节流 -
"env": {"PYTHONIOENCODING": "utf-8"}：对 Python 类工具有效；对其他语言，得查它自己的环境变量（如TCL_ENCODING） -
"file_regex": "^(.*?):([0-9]+):([0-9]+): (.*)$"：必须和你工具实际输出格式严格一致，比如 Zig 输出是./main.zig:4:5: error: …，那就得匹配三段 - 交互式运行？Sublime 内置构建系统不支持 stdin 输入，按
Ctrl+B后输不了字——要么加"shell": true并重定向（不稳定），要么用Terminus插件另起终端
最常被忽略的一点：$file 变量要求文件已保存。未命名的 Untitled 标签页，$file 展开为空，命令直接失效——非标语言通常没 fallback 机制，不会读取编辑器内存内容。
