Sublime构建系统传参需用variants定义含${args}的变体，cmd数组不解析变量，须用shell_cmd配合"shell": true；注意空格分隔、路径引号转义及selector匹配。
Sublime构建系统怎么传命令行参数
默认的 Ctrl+B 不支持传参，必须用 variants 定义一个带 ${args} 占位符的变体。直接改 cmd 字段无效，因为 cmd 是静态数组，不解析变量；只有 shell_cmd 在 shell: true 下才支持字符串插值。
-
shell_cmd必须配合"shell": true，否则${args}不展开 -
${args}前后要留空格，比如"python -u \"$file\" ${args}"，否则参数会粘连成一个词 - Windows 下双引号必须转义，写成
\"$file\"，不然 JSON 解析失败 - 如果参数含空格或特殊字符（如
--input "a b.txt"），shell_cmd能正确处理，而cmd数组需要手动拆分并加引号——不推荐
为什么 Run with Args 按下没反应
常见现象是按 Ctrl+Shift+B 选了变体，弹出输入框，输完回车后底部状态栏一闪而过、输出面板空白。这不是脚本没运行，而是构建系统根本没触发执行流程。
- 检查
selector是否匹配当前文件：比如写的是"selector": "source.python"，但文件后缀是.pyw或未保存（无后缀），就不会激活 - 确认构建系统已保存为
.sublime-build文件，且在Packages/User/目录下——放在别处 Sublime 不加载 - 终端里手动跑
python -u "test.py" arg1能成功，但 Sublime 不行？大概率是shell_cmd中路径没加引号，遇到空格路径直接截断 - Mac/Linux 用户注意：
shell_cmd默认走/bin/sh，不兼容bash特性（如[[ ]]），保持简单命令
Python 脚本里怎么安全读取参数
别依赖 input() 等交互式方式——构建系统输出是单向流，input() 会卡住且无提示。所有参数必须通过 sys.argv 显式接收，并做长度校验。
- 最简健壮写法：
if len(sys.argv) + <code>print("Usage: ...")+sys.exit(1) - 避免直接用
sys.argv[1]，先检查索引是否存在，尤其当用户没输参数时 - 如果用了
argparse，确保parser.parse_args()不带参数——它默认从sys.argv[1:]读，正好匹配构建系统传入行为 - 测试时用
sys.argv = ["test.py", "arg1", "--flag"]手动模拟，比反复切 Sublime 更快
项目级参数配置怎么隔离
同一个构建系统在多个项目中复用时，参数习惯可能不同（比如 A 项目总带 --dev，B 项目总要 --config prod.yaml）。硬编码进 shell_cmd 会污染通用配置。
- 用
.sublime-project文件覆盖build_systems，在variants里重写shell_cmd，例如："shell_cmd": "python -u \"$file\" --dev ${args}" - 不建议在项目文件里写死全部参数，仍保留
${args}，只是前置固定部分——兼顾复用与定制 - 如果参数逻辑复杂（如根据文件名自动加不同 flag），就得换方案：用 Terminus 插件起外部终端，或写个 wrapper shell/bat 脚本再调用 Python
真正麻烦的不是写那几行 JSON，而是每次改完都要关掉输出面板、清空旧缓存、重启构建选项——Sublime 不自动重载 .sublime-build 文件，保存后得手动切换一次构建系统才能生效。
