Sublime Text构建系统还支持$file_base_name、$file_extension、$project、$project_path、$packages、$platform等变量，其中$project_path为空时会导致cmd失败，$platform用于跨平台variants判断，变量不可嵌套拼接。
Sublime Text的$file和$file_path之外还有哪些可用变量？
Sublime Text 的构建系统支持一组内置变量，它们在运行时被替换成实际路径或字符串，但不是所有变量都默认生效——有些只在特定上下文（比如项目打开时）才可用，有些则依赖 shell 环境。
最常被误用的是$project和$project_path：前者仅在项目文件（.sublime-project）存在且已加载时才展开为项目名，后者才是项目根目录的绝对路径；若没开项目，它为空字符串，导致cmd执行失败。
-
$file_base_name：当前文件名（不含扩展名），适合生成同名可执行文件，如gcc $file -o $file_base_name -
$file_extension：扩展名（含点），如.py，注意不是py -
$packages：Sublime Packages 目录路径，可用于引用插件自带脚本，例如"$packages/ShellScript/shell_exec.sh" -
$platform：值为windows、osx或linux，配合variants做平台判断时必须用这个，不能靠os.name或环境变量
变量不支持嵌套或拼接，比如"$file_path/logs/$file_base_name.log"是合法的，但"$file_path + '/logs'"会原样传给 shell，直接报错。
如何用variants实现“编译 → 运行 → 清理”三阶段构建？
单纯靠一个cmd数组做不到多步顺序执行，因为 Sublime 的构建系统默认只运行一条命令。真正可行的方式是把多阶段逻辑压进 shell 封装里，再用variants做语义分组——不是“自动连跑三步”，而是让用户手动选“编译”、“运行”或“清理”，避免误操作。
关键点在于：每个variant必须有"name"字段，且不能与主cmd冲突；Sublime 不会自动串联变体，也不会校验依赖关系。
- 主配置保留基础编译动作，比如 C 文件的
gcc -c - 新增
variants数组，每个对象定义独立cmd，例如："name": "Run"对应["bash", "-c", "$file_path/$file_base_name"] - 清理任务建议用
shell_cmd而非cmd数组，避免 Windows 下del和 Linux 下rm语法差异，统一走 shell 解析 - 如果某阶段需前置条件（如“运行”前必须已编译），得靠命名约定或文档提醒，Sublime 不做检查
示例中常见错误是把variants写成"cmd": ["make clean && make && ./a.out"]——这看似一步到位，实则错误输出无法被file_regex捕获，报错行点击跳转失效。
为什么shell_cmd比cmd更适合带管道或重定向的场景？
cmd是数组形式，每个元素作为独立参数传给进程，不经过 shell 解析，所以|、>、&&这些符号会被当成字面量传给程序，导致命令失败；而shell_cmd是字符串，由系统 shell（sh或cmd.exe）执行，支持完整 shell 语法。
但代价是跨平台风险陡增：Linux/macOS 下shell_cmd走/bin/sh，Windows 默认走cmd.exe，二者语法不兼容。比如echo $PATH在 Windows 下不会展开环境变量。
- Windows 用户若要用
shell_cmd，推荐显式调用PowerShell：如"shell_cmd": "powershell -Command "& { .\$file_base_name.ps1 }"" - Linux/macOS 下，
shell_cmd中用单引号包裹变量可防止提前展开，例如'python -m pytest "$file_base_name"' - 混合使用
cmd和shell_cmd在同一配置中是允许的，但不能共存于同一构建项——要么全用cmd，要么全用shell_cmd
真正容易被忽略的是：一旦用了shell_cmd，working_dir仍生效，但 shell 启动后是否 cd 进该目录，取决于 shell 自身行为，不是 Sublime 控制的。
构建系统里env字段能解决哪些编码和路径问题？
env用于注入环境变量，它不改变系统全局环境，只影响本次构建进程的子环境。对 Python 来说，"PYTHONIOENCODING": "utf-8"能强制标准流编码，避免中文print()乱码或input()卡死；对 Node.js，"NODE_OPTIONS": "--enable-source-maps"可开启调试支持。
但它无法覆盖 shell 启动时已继承的变量，比如你设了"PATH": "/usr/local/bin"，但 shell 自己的PATH包含/usr/bin，最终 PATH 是两者拼接还是覆盖，取决于 shell 实现——Sublime 不干预。
- Windows 下路径含空格时，
env里设"PYTHONPATH"比硬编码到cmd更安全，避免引号嵌套混乱 -
env中键名区分大小写，Linux/macOS 下"path"无效，必须是"PATH" - 若需动态生成环境变量（如从项目配置读取），只能靠外部脚本，JSON 配置本身不支持表达式
复杂点在于：不同语言对环境变量的读取时机不同。Python 在启动时读PYTHONIOENCODING，但 Go 程序可能忽略它；C++ 编译器根本不用这个变量。别指望一个env字段通吃所有场景。
