${args}是sublime构建系统中仅在shell_cmd字段有效的参数占位符，需配合variants中名为“run with args”的变体触发输入，cmd数组不解析变量；使用时须注意shell_cmd中路径加引号、正确设置shell:true、避免引号嵌套问题，并通过env或封装脚本管理python环境。
Sublime构建系统里${args}到底怎么用
构建系统本身不主动弹出参数输入框，${args}只是个占位符，必须配合variants里的shell_cmd和“Run with Args”这类变体才能触发输入。直接写在cmd字段里完全无效。
常见错误是把${args}塞进cmd数组里，比如："cmd": ["python", "$file", "${args}"]——这会导致Sublime尝试执行一个叫${args}的字面量文件名，而不是展开参数。
-
cmd字段只支持数组形式，不解析变量；shell_cmd才支持${args}、$file等变量展开 - 必须定义
variants，且其中一项的name要可识别（如"Run with Args"），否则Ctrl+Shift+B菜单里根本看不到选项 - 保存后需手动在Tools → Build System中选中该构建系统，否则快捷键不会绑定到它
为什么输完参数没反应或报错command not found
最常踩的坑是shell_cmd里没加引号或转义不对，导致空格分隔的参数被shell拆解失败。例如"shell_cmd": "python -u \"$file\" ${args}"中，$file必须用双引号包裹，否则路径含空格时直接崩。
- Windows下PowerShell默认策略会拦截未签名脚本，
shell_cmd得显式加-ExecutionPolicy Bypass - macOS/Linux若用zsh/bash，
${args}传入的--verbose --port 8000会被正确拆成三个独立参数；但若构建系统配置了"shell": false（默认值），shell_cmd就根本不会走shell解析，${args}直接当字符串丢给程序 - 确认你的Python脚本真用了
sys.argv，而不是argparse却忘了parser.parse_args()——参数传过去了，脚本自己没接住
想让参数自动带进Terminus终端里怎么办
Terminus不读构建系统的${args}，它压根不参与Sublime的构建流程。想让它跑带参命令，只能绕过构建系统，用terminus_open命令硬编码或动态拼接。
- 最稳的方式：建一个
Build in Terminus.sublime-commands，内容里"shell_cmd"直接写死，比如"python \"$file\" --debug" - 如果非要动态传参，得写Python插件监听
on_post_build事件，再调用terminus_open并注入当前参数——原生不支持 - 注意Terminus默认不加载
~/.zshrc，npm、poetry等工具可能找不到，得在Terminus设置里把shell改成/bin/zsh --login
多版本Python或自定义解释器路径怎么传参
别改shell_cmd里的python为绝对路径再加${args}，容易漏转义。更可靠的是用env字段隔离环境，或靠外部封装脚本中转。
- 在构建系统里加
"env": {"PATH": "/opt/homebrew/bin:/usr/local/bin:$PATH"}，比硬写/opt/homebrew/bin/python3更灵活 - 如果用
pyenv或conda，建议不用${args}直传，而是写个wrapper.sh：#!/bin/sh; exec $(pyenv which python) "$@"，然后shell_cmd调它 -
${args}不处理引号嵌套，比如传'{"key":"val"}'会崩，这种场景应改用临时文件或环境变量传递
