Sublime Text的Build System本质是调用本地已安装工具的外部命令任务，需先验证终端中python3 --version等命令可用；配置文件必须存于Packages/User/目录且后缀为.sublime-build；推荐使用cmd数组而非shell_cmd以确保跨平台安全；变量如$file仅在文件已保存时生效，且须匹配右下角显示的syntax scope才能触发。
Sublime Text 内置的 Build System 不是“开箱即用的编译器”，它压根不自带任何编译器或解释器——你看到的 Python、C++ 等默认构建项，只是调用你系统 PATH 里已有的 python、g++ 命令的壳子。如果终端里 python --version 都报错，那内置 Build System 就会静默失败，连错误提示都不给你。
为什么 Ctrl+B 按了没反应？先查 selector 和文件保存状态
Build System 是否自动启用，只取决于两件事：当前文件的 syntax scope 是否匹配配置里的 selector，以及文件是否已保存。
-
selector必须精确匹配，比如 Python 文件对应的是"source.python"，不是"python"或"text.python" - 按
Ctrl+Shift+P输入show scope回车，看输出里有没有source.python—— 没有就说明语法高亮没生效，Build System 不会触发 -
$file变量只在已保存文件中展开；Untitled 标签页下它为空，命令变成["python", ""]，直接报错或无声退出 - 未保存文件想运行？不行。Build System 没有
$file_content这种变量，也不读内存内容
cmd 数组 vs shell_cmd 字符串：跨平台安全写法必须选前者
Windows 下 shell_cmd 几乎必然失效：$file 变量不被 cmd.exe 解析，含空格路径（如 C:Program FilesPython312python.exe）不加引号就崩，&& 连接符也不认。
- ✅ 安全写法：
"cmd": ["python", "-u", "$file"]—— Sublime 自动拼接参数，天然兼容空格和跨平台 - ❌ 危险写法：
"shell_cmd": "python $file"—— Windows 直接报 “不是内部或外部命令” - Windows 绝对路径必须双反斜杠 + 双引号：
"cmd": ["C:\Program Files\Python312\python.exe", "-u", "$file"] - macOS/Linux 推荐用
which python3查真实路径，避免依赖模糊的python别名
错误跳转靠 file_regex，但正则写错等于白配
双击错误行跳转到源码，依赖 file_regex 正确提取文件路径和行号。Python 默认错误格式是 File "xxx.py", line 42，C/C++ 编译器输出则是 foo.c:17:5: error:，两者正则完全不同。
- Python 适用：
"file_regex": "^[ ]*File "([^"]*)", line ([0-9]*)" - GCC/Clang 适用：
"file_regex": "^([^:]*):([0-9]+):([0-9]+):"（匹配file.c:10:5:） - 正则不匹配 → 输出面板里文字变蓝可点击，但点不动；调试时打开控制台（
Ctrl+`），看是否有Unable to parse...提示 - 别漏掉
working_dir设为"$file_path"，否则相对路径导入会失败
环境变量、虚拟环境、多命令链式执行怎么搞？
Build System 的 env 字段能设环境变量，但无法动态切换 Python 虚拟环境——激活脚本（source venv/bin/activate）是 shell 行为，cmd 数组不走 shell。
- 要进虚拟环境，必须用绝对路径调解释器：
"cmd": ["/path/to/venv/bin/python", "$file"]（macOS/Linux）或["C:\myproject\venv\Scripts\python.exe", "$file"]（Windows） - 需要链式操作（如编译 + 运行 C 文件），只能用
shell_cmd+"shell": true，并明确指定 shell（PowerShell on Windows，bash/zsh on macOS/Linux） -
variants是唯一干净支持多动作的方式：一个配置里定义 “Run”、“Debug”、“Test”，按Ctrl+Shift+B弹出菜单选 - 中文乱码？加
"env": {"PYTHONIOENCODING": "utf-8"}，比改系统 locale 更直接
真正卡住人的从来不是 JSON 语法，而是 $file 居然要求文件必须保存、selector 匹配不上就完全不触发、Windows 路径里少一个反斜杠就整个构建静默失败——这些点不亲手试一遍，光看文档根本意识不到。
