参数处理
占位符命名空间
三个命名空间完全隔离:
变量(先行展开)
${byk_dir} / ${file_dir} / ${deps_dir} 以及 $var 声明的变量,在占位符解析之前由 byk 替换为字面量,不属于上述参数命名空间——它们不消耗任何参数位置,也不接受输入值。${args} / ${N} / ${...args} 仍由参数层处理。详见 变量。
占位符一览
消耗规则
{xxx}/{{xxx}}消耗xxx及其紧跟的值(共 2 个位置){xxx?}/{xxx?渲染1}/{xxx?渲染1:渲染2}只消耗xxx本身(1 个位置)${N}消耗位置 N- 同一占位符多次出现,只消耗一次,值复用
${...args}的剩余 = 所有原始参数 - 已被消耗的位置,按原始顺序拼接
无值 / 无占位符行为
无占位符行为
别名中不含任何占位符时,自动追加所有原始参数,等价于末尾隐式追加 ${args}。兼容 find 命令中的裸 {}(如 find . -exec ... {} +),不会被解析或替换。
无值行为
任何占位符取不到对应的值时,静默消失,不报错。参数缺失导致的错误由底层命令的运行时处理。
参数保真
命令最终交给 sh -c 解释,所以每个参数在拼进命令时都会被单引号包裹——边界由引号守住,不再交给 shell 重新切分:
只有纯字母数字(外加 - _ . / : = @ + ,)的值不加引号,所以提示行里 cp src dst 依然是原样;需要引号时才会看到 cp 'my file.json' dst。
参数不会再被 shell 展开
*、~、$VAR 都在你敲命令时由你自己的 shell 处理过一次了——byk probe *.json 里的 * 在 byk 拿到之前就已经展开成文件列表。所以 byk 侧按字面传,是保真而不是丢失。
Windows
cmd 侧用双引号包裹,已知不保真的只剩 %VAR%:cmd 在引号内照样展开环境变量,命令行上也没有可靠的转义写法(%% 只在批处理文件里有效)。