build variants 是 sublime build system 中同一构建系统下多个可选动作的机制，用于封装编译、运行、监听等组合操作；需通过 ctrl+shift+b（windows/linux）或 cmd+shift+b（macos）调用，而非 ctrl+b。
什么是 build variants，为什么不能只靠 Ctrl+B
Build variants 是 Sublime Build System 里“同一个构建系统下多个可选动作”的机制。比如你写完一个 C++ 文件，既要编译，又要运行，还要带调试参数——全塞进一个 cmd 里既难维护又容易冲突。Ctrl+B 只能触发主构建；真正切换动作，得靠 Ctrl+Shift+B（Windows/Linux）或 Cmd+Shift+B（macOS）呼出变体菜单。
- 没配 variants 时，想运行编译后的程序只能切终端手动敲
./a.out，效率低还容易 cd 错目录 - variants 不是“额外功能”，而是把常见组合操作（编译+运行、watch 模式、清理 dist）封装成一键可选项
- 它不增加构建耗时，只是在 JSON 里多定义几个
"name"和对应的"cmd"数组
variants 的基本写法和必填字段
一个可用的 variant 至少要有 "name" 和 "cmd"，且必须嵌套在顶层 "variants" 数组里。注意：它不是独立文件，而是主构建系统的子结构。
-
"name"是你在Ctrl+Shift+B菜单里看到的名字，建议用英文、无空格（如"Run"、"Watch"），避免中文乱码或解析异常 -
"cmd"必须是数组形式，每个参数单独一项：["node", "$file"]✅，["node $file"]❌（后者会被当做一个字符串，找不到命令） - 如果要跨平台兼容（比如 Windows 下用
start cmd /k，macOS 用open -a Terminal.app），得用"windows"/"osx"块包裹整个"cmd"，不能只改参数 - 变体默认继承主构建的
"working_dir"和"shell"，但可以单独覆盖——比如主构建设"shell": false，而"Run"变体设"shell": true来支持&&连接符
常见踩坑：为什么你的 variant 点了没反应？
现象通常是按下 Ctrl+Shift+B 后菜单里没选项，或者点了报错 command not found 或 permission denied。根本原因往往不在语法，而在执行上下文。
-
"working_dir"没设对：比如 C++ 主构建设了"working_dir": "$file_path"，但"Run"变体的"cmd"直接写["./$file_base_name"]，结果找不到可执行文件——因为$file_base_name默认不含路径，得显式拼成"$file_path/$file_base_name"（Windows 下用反斜杠） -
"shell": true缺失：Windows 下想用&&或start，Linux/macOS 想用管道或重定向，都必须加"shell": true，否则 shell 特性完全不生效 - 环境变量不加载：GUI 启动的 Sublime（比如从开始菜单点开）通常不读取你的 shell profile（如
~/.zshrc），导致npx、g++找不到。解决方案是用绝对路径（如"/usr/local/bin/npx"）或在"env"字段里补全PATH - 文件权限问题：Linux/macOS 下生成的可执行文件默认无执行权限，
"Run"变体直接调用会报permission denied。可在主构建的"cmd"末尾加"chmod", "+x", "$file_base_name"，或让 variant 自己先chmod再运行
实用变体示例：从编译到 watch 的真实链路
以 Webpack 项目为例，一个完整的构建系统常需要三个动作：一次构建、监听构建、清理输出。它们共享同一套配置，但命令完全不同。
{
"cmd": ["npx", "webpack", "--config", "webpack.config.js"],
"selector": "source.js",
"working_dir": "${project_path}",
"shell": true,
"variants": [
{
"name": "Watch",
"cmd": ["npx", "webpack", "--watch", "--config", "webpack.config.js"]
},
{
"name": "Clean",
"cmd": ["rm", "-rf", "dist/"]
}
]
}
-
"Watch"变体省去重复写--watch参数，也避免误删主构建逻辑 -
"Clean"用rm -rf（macOS/Linux）或rd /s /q dist（Windows）实现跨平台清理，注意 Windows 需单独用"windows"块定义 - 所有变体共用
"working_dir": "${project_path}"，确保npx能定位到项目级node_modules/.bin/webpack
最易被忽略的是："Watch" 模式一旦启动，Sublime 的构建面板就卡住等待输入，此时不能再按 Ctrl+B 触发其他构建——得先用 Ctrl+Break（Windows/Linux）或 Cmd+.（macOS）中断，否则后续操作全被阻塞。
