sublime构建系统不支持运行时动态传参，参数需在配置中写死或用内置变量（如$file、$file_base_name）自动适配当前文件；真正交互式输入需借助外部脚本或插件。
Sublime 的构建系统本身不支持运行时动态传参（比如 Ctrl+B 时弹窗输入），所有参数必须在配置文件里写死、用内置变量替换，或靠外部命令间接实现。
用 $file 和其他内置变量替代“手动输参数”
多数人想“传参”，其实是希望构建命令能自动适配当前文件。这不是靠交互输入，而是靠 Sublime 提供的变量展开：
-
$file展开为当前已保存文件的绝对路径（未保存的Untitled会变为空，导致命令失败） -
$file_base_name是不含扩展名的文件名，常用于生成可执行文件名，如gcc "$file" -o "$file_base_name" -
$file_path是文件所在目录，working_dir设为它才能让相对路径命令正常工作 - Windows 下路径含空格时，
cmd数组中每个含路径的元素必须用双引号包裹，且反斜杠要写成\
需要真正“运行时参数”？只能靠 shell_cmd + 外部工具
Sublime 原生不支持构建时弹出输入框或读取选中文本作为参数，但有两个可行路径：
- 用
shell_cmd拼接 shell 命令，并利用$selection变量（需配合插件支持，原生不识别）——例如测试框架中按标签运行：./tests '$selection'，前提是安装了支持该变量的插件（如Selection Build） - 把参数逻辑移到脚本层：写一个 wrapper 脚本（如
run-with-args.sh），在shell_cmd中调用它，再由脚本处理交互或环境判断 -
args字段不能和cmd共存，且只在cmd模式下生效；它不是“用户输入”，只是配置文件里预设的额外参数数组
env 字段才是传环境变量的唯一正路
很多人误以为改系统 PATH 或在 shell 里 export 就能让构建系统看到，其实完全无效：
- Sublime GUI 进程不继承终端的环境变量（macOS/Linux 尤其明显；Windows 更彻底）
- 必须显式在构建配置中用
"env": { "PYTHONPATH": "$project_path/lib", "PATH": "/opt/homebrew/bin:$PATH" }—— 注意：这里的$PATH不会被展开，得写死或用脚本读取 -
$project_path比$file_path更可靠，它指向整个项目根目录，避免单文件打开时路径错乱 - 如果只是想让 Python 脚本接收
--env dev这类参数，别动env，直接写进cmd或shell_cmd里更干净
为什么 cmd 写成字符串就静默失败？
这是最常踩的坑：Sublime 要求 cmd 必须是数组，哪怕只有一个命令：
- ✅ 正确：
"cmd": ["python", "-u", "$file"] - ❌ 错误：
"cmd": "python -u $file"—— 不报错，但构建完全没反应 - 数组形式能准确分隔参数，避免空格、引号、特殊字符被 shell 错误解析；而字符串形式只在
shell_cmd中合法 - Windows 下若用
shell_cmd调cmd /c，要注意双引号嵌套和转义，不如老实用cmd数组 +"shell": true
真正麻烦的从来不是语法怎么写，而是搞清变量在哪一刻展开、PATH 从哪来、$file_path 到底指哪个目录——这些细节不会报错，只会让你花半小时调试一条本该一秒跑通的命令。
