Sublime Text自定义构建系统是必须存于Packages/User/目录、格式严格的JSON文件，字段如cmd（数组格式）、selector（语法作用域而非扩展名）、working_dir等语义明确，任一错误均导致Ctrl+B静默失效。
Sublime Text 的自定义编译系统不是“插件”或“设置开关”，而是一个必须放在特定路径、格式严格、字段语义明确的 JSON 文件。放错位置、少一个逗号、selector写成.py而不是source.python，都会导致 Ctrl+B 完全没反应——不是报错，是静默失效。
Build System 文件必须存到 Packages/User/ 目录下
Sublime Text 只加载 Packages/User/ 下的 .sublime-build 文件，其他任何位置（桌面、项目根目录、Packages/MyLang/）一概无视。这不是“可能不生效”，而是硬性限制：文件放错，菜单里根本不会出现对应构建项，按 Ctrl+B 也完全没反应。
实操建议：
- 用菜单 Preferences → Browse Packages… 直接打开
Packages/目录，再进入User/子文件夹 - 在该目录下新建文件，后缀必须是
.sublime-build（例如Python3_Run.sublime-build） - 别双击桌面文件再拖进 Sublime —— 这样保存路径仍是桌面，不会自动移到
User/
cmd 字段必须是数组，且路径含空格要加引号转义
cmd 是命令执行的核心，但它不是字符串，而是 JSON 数组。Windows 路径含空格时，整个解释器路径必须用双引号包裹，并用双反斜杠转义；macOS/Linux 依赖 PATH，但多版本共存时建议写死解释器路径，避免 python 别名指向错误版本。
常见错误现象：Unable to find command python3，或命令一闪而过无输出。
实操建议：
- Windows：
"cmd": ["C:\Program Files\Python39\python.exe", "-u", "$file"]（注意双反斜杠 + 引号包裹整个路径） - macOS/Linux：
"cmd": ["python3.11", "-u", "$file"]（先运行which python3.11确认真实路径） - 务必加
-u参数：禁用输出缓冲，否则print()内容可能延迟显示甚至不显示
selector 匹配的是语法作用域，不是文件扩展名
selector 决定该构建系统是否自动激活。它匹配的是 Sublime 内部的语法作用域（scope），比如 Python 文件是 source.python，C 文件是 source.c，不是 .py 或 .c。匹配不上，即使文件后缀正确，也不会默认选中该构建系统。
实操建议：
- 打开一个目标文件（如
test.py），按Ctrl+Shift+P（Windows）或Cmd+Shift+P（macOS），输入 Inspect Scope 查看当前光标处的实际 scope - 常见 scope 值：
source.python、source.c、source.cpp、source.shell - 想“万能运行”任意文本文件，可用
"selector": "source | text"，但需配合shell_cmd和脚本判断后缀
中文路径、乱码、交互输入这些坑，靠 env 和 working_dir 补救
中文路径本身不直接导致失败，但会引发编码问题（尤其 Windows 默认 GBK）；stdin 输入阻塞、输出闪退、错误跳转不准，往往是因为缺少环境变量或工作目录没设对。
实操建议：
- 强制 UTF-8 编码：
"env": {"PYTHONIOENCODING": "utf-8"}（Python）或{"LANG": "en_US.UTF-8"}（Linux/macOS） - 设工作目录：
"working_dir": "$file_path"（确保gcc找得到头文件、import找得到模块） - 需要交互输入？不要依赖构建面板——它不提供伪终端（pty）。改用
shell_cmd调起外部终端，例如 Windows："shell_cmd": "start cmd /c "python -u $file & pause""
最常被忽略的一点：JSON 格式错误会导致整个 Packages/User/ 下所有构建系统失效。哪怕只是少了个逗号，Ctrl+B 就会彻底静默。建议粘贴配置到 jsonlint.com 快速校验，而不是靠肉眼排查。
