Sublime Text的Build System本质是调用本地已安装工具（如python3、g++）的JSON配置文件，需存于Packages/User/目录且后缀为.sublime-build；必须先验证终端中对应命令可用，未保存文件时$file变量为空，cmd数组比shell_cmd更跨平台安全。
Build System 本质是调用本地命令，不是“内置编译器”
Sublime Text 自身不带任何解释器或编译器，Build System 只是一个 JSON 配置驱动的外部命令触发器。它做的唯一一件事：拼好参数、调用你系统 PATH 里或硬编码路径下的可执行文件（比如 python3、g++、node），然后把输出塞进 Sublime 的 Build Results 面板。
这意味着：
- 如果终端里运行
python3 --version报错，那无论.sublime-build写得多漂亮，构建都会静默失败或报 “Unable to find command” - Windows 上
python和python3常常指向不同版本，建议直接用python3.11或完整路径，避免别名歧义 - macOS/Linux 用户若装了 pyenv 或 conda，需确认当前 shell 的
which python3输出与 Sublime 启动环境一致（GUI 应用可能不读 shell profile）
变量如 $file 依赖真实磁盘路径，未保存 = 空字符串
$file 不是编辑器内存里的内容快照，而是 Sublime 向操作系统查询的当前文件的绝对路径。只要标签页还是 Untitled，它就展开为空 —— 命令变成 ["python3", "-u", ""]，结果要么报错，要么什么也不做。
常见误操作：
- 写完代码直接按
Ctrl+B，没先Ctrl+S→ 构建失败且无提示 - 以为
$file_content存在，试图在cmd中传入未保存内容 → 该变量根本不存在，JSON 解析会失败 - 在
working_dir字段里写"$file_path"→ 无效，变量只在cmd或shell_cmd中生效
cmd 数组比 shell_cmd 更可靠，尤其跨平台时
cmd 是字符串数组，Sublime 自己负责参数拼接和空格转义；shell_cmd 是单个字符串，交由系统 shell 解析，而 Windows 的 cmd.exe 和 macOS/Linux 的 bash 对变量、引号、&& 的处理完全不同。
典型陷阱：
- Windows 下写
"shell_cmd": "python3 $file"→$file不被识别，报 “不是内部或外部命令” - 路径含空格（如
C:\Users\My Name\script.py）时，shell_cmd很容易断成两截，cmd数组天然规避此问题 - 需要重定向或管道（如
python script.py > out.txt）必须用shell_cmd，但得加"shell": true并确保目标 shell 支持（PowerShell 而非 cmd）
配置生效位置极其严格：只认 Packages/User/
Sublime 不扫描项目目录、桌面或任意子文件夹。它只加载两个地方的 .sublime-build 文件：内置只读包（不可改），以及用户级 Packages/User/ 目录。
实操要点：
- 用菜单
Preferences → Browse Packages…打开目录，直接进User/子文件夹操作，别靠记忆手输路径 - 文件名可以是任意合法名，但后缀必须是
.sublime-build（.json或.build都不行） - 改完保存后，部分 Sublime 版本不会自动刷新菜单，需手动执行
Tools → Build System → Refresh Projects，或重启编辑器 - 配置里写了
"selector": "source.python"，但右下角显示的是Plain text？那这个构建系统根本不会被自动选中 —— syntax scope 必须匹配
最易被忽略的一点：Build System 没有“调试模式”，出问题时第一反应不该是改 JSON，而是打开系统终端，用完全相同的命令（替换掉 $file 为实际路径）手动跑一遍 —— 如果终端里都失败，Sublime 肯定也失败。
