Bash printf 打印 -- 时只显示 usage

Bash 脚本想打印两个短横线，写了 printf "--"，结果没有输出分隔符，而是显示用法：

printf: usage: printf [-v var] format [arguments]

这里不是引号缺失。Bash 的 printf 内建命令把第一个 -- 当成选项结束标记，处理完它以后，命令里已经没有必需的格式字符串。要输出这两个字符，可以把它们作为固定格式的参数：

printf '%s\n' '--'

上述命令会多输出一个行末换行。不需要换行时使用 printf '%s' '--'。这里的 - 是 ASCII 连字符减号，不是排版中的长破折号或短破折号。

引号保护参数，不改变选项含义

Bash 处理引号后，"--" 与 '--' 都会向命令传入同一个字符串。引号能防止字段拆分和路径名展开，却不会给参数附加“它只是普通文本”的标记。

printf 接受 -v 等选项，因而也识别用于结束选项的 --。类似地，把 -1 或 -x 直接放在格式字符串的位置，可能得到 invalid option。它们不是数值计算错误，也不是字符串不能以短横线开头，而是参数先进入了选项解析。

以下说明针对 Bash 内建 printf。脚本实际调用的命令可用下面的只读检查确认：

type -a printf

如果项目定义了同名函数或别名，应先核对包装层。外部 /usr/bin/printf 和其他 shell 内建命令的选项可能不同，不能用外部命令的帮助页代替 Bash 的接口规则。

固定格式放前面，待输出的数据放后面

对于普通文本变量，不要写成 printf "$message"。变量除了可能以短横线开头，还可能含 %s、%d 或反斜杠序列，被当成格式语法。

可以用不含敏感信息的小样本检查：

message='-- progress=100% path=C:\logs'
printf '%s\n' "$message"

按这个格式，应原样输出 message 中的文本，再追加一个换行。%s 从后一个参数读取字符串，不会再把该参数里的百分号和反斜杠作为新的格式重新解析。变量的双引号仍然需要保留，避免空格和通配符在调用之前被 shell 拆开或展开。

如果变量原本就包含末尾换行，%s\n 会再加一个；要求只输出原文本时选择 %s。这两种输出约定要按日志或下游协议决定，不能为了消除错误随手改变行数。

不要把 %s 换成 %b 作为所谓更通用的文本输出。Bash 的 %b 会解释参数里的反斜杠转义，适合明确需要转义展开的内容，不适合这里的字面文本。

真正以短横线开头的格式，用 -- 隔开

如果格式本身需要带前缀，并且仍要使用格式占位符，可以明确终止选项解析：

file='report.txt'
printf -- '--file=%s\n' "$file"

第一个 -- 是分隔符，第二个参数 --file=%s\n 才是格式。对于只输出两个短横线且不追加换行，也可以写 printf -- '--'。

但 -- 只结束选项解析，不会关闭格式解析。例如 printf -- "$message" 仍把 message 作为格式；如果它含百分号或转义，含义仍可能改变。输出不受程序控制的文本时，继续使用固定的 %s 格式。

格式应由程序明确编写，参数才承载变量数据。不要用 eval 重新拼接执行字符串，也不要为了避开 printf 改用行为不一致的 echo 选项组合。

用不同输入检查输出协议

修改时至少检查 --、-1、含百分号、含反斜杠、含空格和空字符串的值。可以在只写标准输出的独立 Bash 测试脚本中逐项核对，不连接真实导入、发送或删除命令。

输出正常还要看退出状态。printf 的非零状态也可能来自输出写入失败；把选项和格式分开以后，不能再把所有失败都认作同一个参数问题，更不能在批处理里统一追加 || true 隐藏它们。

这项修复只涉及输出表达式，无需更改数据内容。保留原脚本版本，确认是否追加换行、是否保持字面文本，以及下游接收到的格式后再使用。回退代码不会恢复已经被错误格式化并写出的日志或文件；如需重新生成，使用保留的原始数据。