Sublime Text的Build System本质是调用本地已安装工具（如python3、g++）的外部命令任务，需先验证终端中python3 --version等命令可用；配置文件必须存于Packages/User/目录且后缀为.sublime-build；推荐使用cmd数组而非shell_cmd以确保跨平台安全；变量如$file仅在文件已保存时生效，且须匹配右下角显示的syntax scope才能触发。
Sublime Text 的 Build System 不是“配置编译器”，而是定义一个能调用你本地已装工具（如 python3、g++、node）的外部命令任务；如果终端里都跑不通 python3 --version，那任何 .sublime-build 文件都会静默失败。
Build System 文件必须放在 Packages/User/ 目录下才生效
Sublime Text 只从固定位置加载构建系统：不是桌面、不是项目根目录、也不是任意子文件夹，仅认 Packages/User/。放错地方 = 配置不存在。
- Windows：菜单 Preferences → Browse Packages…，进
User/文件夹 - macOS：菜单 Sublime Text → Preferences → Browse Packages…，同样打开
User/ - Linux：
~/.config/sublime-text-3/Packages/User/（路径可能含sublime-text或sublime-text-3） - 文件名随意，但后缀必须是
.sublime-build，例如Python3Run.sublime-build - 改完保存后，执行 Tools → Build System → Refresh Projects，或重启 Sublime
cmd 数组比 shell_cmd 更安全、更跨平台
shell_cmd 是字符串，依赖 shell 解析，Windows 的 cmd.exe 不认识 $file 变量，macOS/Linux 的 bash 虽能解析，但空格、引号、&& 容易崩；cmd 是数组，Sublime 自动拼接参数，天然规避路径空格和 shell 兼容问题。
- ✅ 推荐写法：
"cmd": ["python3", "-u", "$file"] - ❌ 危险写法：
"shell_cmd": "python3 $file"（Windows 下直接报 “不是内部或外部命令”） - ⚠️ Windows 上若硬要用
shell_cmd做链式操作（如编译+运行），得加"shell": true并切到 PowerShell，否则&&不生效 -
$file等变量只在cmd数组或shell_cmd字符串中有效，写在working_dir里是无效的
文件必须已保存，$file 才有值
Build System 依赖磁盘路径展开变量。Untitled 标签页没有真实路径，$file 展开为空字符串，命令变成 python3 ""，结果是报错或无声失败。
- 运行前务必先按
Ctrl+S（Windows/Linux）或Cmd+S（macOS）保存文件 - 不存在
$file_content这种变量，Build System 没法读取未保存内容 -
$file_path是目录路径，$file_base_name是不带扩展的文件名，三者用途不同，别混用 - 想让 C++ 编译时输出可点击跳转错误行？补上
"file_regex": "^(..[^:]*):([0-9]+):([0-9]+):? (.*)$"
为什么按 Ctrl+B 没反应 / 输出一闪而过
这是 Build System 最典型的假性失败：命令其实执行完了，但控制台窗口自动关闭，看不到结果。根本原因不是配置错，而是没告诉 Sublime “等我输入”或“别关窗”。
- Python 脚本末尾加
input()可临时停留，但非长久之计 - 真正解决交互和持续会话，得用插件：
Terminus（推荐）或Terminal，它们在编辑器底部开可交互终端面板 - 插件报
Cannot find command 'python'？不是插件问题，是 Sublime 没继承你的 shell PATH —— macOS 用户尤其注意：必须从终端启动 Sublime：subl . - 中文乱码？加
"env": {"PYTHONIOENCODING": "utf-8"}，Windows 再配合"shell_cmd": "chcp 65001 & python3 -u \"$file\""+"shell": true
最常被忽略的点：右下角显示的 syntax（比如 “Python”）必须匹配 selector 字段，否则构建系统根本不会被触发；查真实 scope 要用 Ctrl+Shift+P → Developer: Show Scope Name，而不是看文件后缀。
