在 Linux 里混久了你会发现真正撑起日常脚本工作的往往不是那些花里花哨的文本处理工具而是像 printf 这样看起来不起眼的命令。很多人对 printf 的印象还停留在 C 语言的printf(hello\n)进了 shell 之后只知道echo hello等到某天要输出一个列宽对齐的表格、要拼一段带大量转义符的配置、要把数字转成十六进制才发现 echo 根本指望不上。这篇文章要把 Linux 命令 printf 从头到尾拆一遍包括格式说明符、宽度修饰符、转义写法、重定向组合以及容易被问到的 printf 面试题和中文乱码排查思路适合正在学 linux 常用命令的初学者也适合写脚本的老手做一次查缺补漏。1. 先用两个例子说清楚为什么写脚本离不开 printf1.1 从一次“表格乱掉”的脚本事故说起以前我在一个数据报表脚本里吃过亏当时图省事全部用 echo 去拼字符串。比如要输出用户名、年龄、成绩三列echo name age score echo alice 28 95.5 echo bob 35 88.3表面看没问题可是只要其中一列出现更长的内容比如charlie变成了christopher整个表格就歪了。更麻烦的是echo 在不同发行版、不同 shell 里的行为还不一样有些环境里echo -e会正常解释\n换到另一个环境就变成了字面量n。这种不确定性在脚本里埋雷等到线上跑挂了才暴露排查起来非常头疼。后来我改成一个关键习惯能用 printf 的场合就不用 echo。printf 的好处是格式完全由你控制列宽、补零、对齐、进制转换都能算得清清楚楚输出行为在 Bash、Dash、Zsh 以及外部命令版本身之间都保持高度一致。它不解决业务逻辑问题但它能解决“输出是否稳定、是否可预期”这个基础问题。1.2 printf vs echo一张表看懂差距总有朋友问我echo 那么短printf 还要带一堆格式串凭什么说它更适合写脚本我用一张表回答对比项echoprintf输出换行默认自动换行需要显式写\n转义序列支持依赖-e各 shell 行为不统一格式串内统一解释常见转义格式化占位符不支持支持%s、%d、%f等列宽与对齐控制不支持支持宽度、左对齐、补零多参数消费空格简单拼接按格式串循环消费进制转换不支持支持十进制/八进制/十六进制输出看到这里为什么说“会 echo 还不够”就很清楚了。echo 适合快速打印一句话printf 适合写需要精确控制的输出逻辑。在 linux 常用命令大全里printf 往往被归类到“文本处理工具”但它实际承担的角色更像是一个微型格式化引擎。脚本越复杂你对输出的确定性要求越高printf 的价值就越明显。1.3 先厘清shell 里的 printf 到底是谁在干活还有一个容易忽略的点你在终端敲 printf 的时候用的很可能不是外部命令。Bash 内部内置了 printftype -a printf能看到类似这样的输出$ type -a printf printf is a shell builtin printf is /usr/bin/printf大多数情况下shell 会优先使用 builtin 版本因为少开一次子进程性能更好。外部命令/usr/bin/printf由 GNU coreutils 提供行为上大部分和 builtin 一致但有一些差异。比如 Bash builtin 支持%q和-v选项而 POSIX 标准里并没有这两个能力。这引出一个实操经验如果你的脚本 shebang 写的是#!/bin/bash放心用%q和-v如果你为了兼容性写#!/bin/sh碰到 Dash 环境这两个扩展功能可能直接报错。我见过不少同事在本地 Bash 跑得好好的脚本部署到精简容器里就挂了最后发现是printf -v在/bin/sh下不可用。所以写脚本之前先确认你的环境到底由谁在解释 printf。2. 现在拆零件格式说明符、修饰符与转义字符2.1 占位符%s、%d、%f、%x、%o 各管一摊printf 的核心是格式串。格式串里普通字符会原样输出而%开头的占位符会从参数列表里取一个值按指定格式输出。平时最常用的几个格式说明符格式符含义示例输出%s字符串printf %s\n hellohello%d十进制整数printf %d\n 4242%i同%dprintf %i\n 4242%f浮点数printf %f\n 3.143.140000%e科学计数法printf %e\n 123451.234500e04%x十六进制小写printf %x\n 255ff%X十六进制大写printf %X\n 255FF%o八进制printf %o\n 810%b解释参数里的转义序列printf %b\n a\tba 与 b 之间是一个制表符%q输出可被 shell 复用的转义形式printf %q\n hello worldhello\ world%b和%s的差别特别值得强调。%s只把参数当普通字符串输出参数里的\n、\t不会被解释。%b则会在输出前解释参数中的反斜杠转义。例如printf %s\n a\tb printf %b\n a\tb第一行输出字面上的a\tb第二行输出a加一个真正的制表符再加b。这个差异在脚本里很容易踩尤其是拿着用户输入的路径去打印时如果你误用了%b路径里刚好有\t这种字符输出就会莫名其妙多出制表符。2.2 修饰符宽度、左对齐、补零如何组合格式说明符还能加修饰符这是 printf 比 echo 强出不止一个量级的地方。最常用的组合是“宽度”和“对齐方式”。printf [%10s]\n hello printf [%-10s]\n hello printf [%05d]\n 42 printf [%-10s|%05d]\n name 42第一行%10s表示最少占 10 列内容默认右对齐所以输出[ hello]。第二行加了一个-变成左对齐输出[hello ]。第三行%05d表示数字占 5 列不够用 0 补输出00042。第四行把字符串左对齐和数字补零组合在一起输出[name |00042]。这种能力在打印日志、生成报表、对齐菜单时非常实用。你不需要再用循环去数空格数量格式串里一写列的宽度就锁死了。精度修饰符.N也很常用。比如浮点数默认输出 6 位小数%.2f则只保留两位printf %.2f\n 3.14159 printf %6.2f\n 3.14159第一行输出3.14第二行在保留两位小数的同时整体占 6 列输出3.14。这里有个小坑精度修饰符对字符串也有作用。%.3s表示最多取字符串的前 3 个字符。这个特性可以用来做短横线截断但如果你不知道这个行为看到字符串被截短了会一脸懵。2.3 转义写法\n、\t、\0nnn、\xHH 和那个老实的 %%printf 格式串里的反斜杠转义也需要记清楚常用的是这些转义含义\n换行\t制表符\r回车\a响铃\\反斜杠本身\双引号\0nnn八进制表示的字符\xHH十六进制表示的字符\uHHHHUnicode 码点例printf \x41\n printf \101\n\x41是十六进制对应 ASCII 字母A。\101是八进制同样对应A。这两个写法在生成字节流时特别有用。比如往文件里写一个只有三个字节的二进制头printf \x48\x49\x21\n header.bin这会生成HI!加换行。你还可以用printf \0输出一个真正的空字节这在某些协议调试场景里比echo靠谱得多。还有一个看上去简单但很多人会忘的写法输出百分号。因为%在格式串里是特殊字符直接写%会被当成格式说明符的一部分所以想输出一个百分号必须写成%%printf 进度%d%%\n 80输出进度80%。如果你忘了写双百分号报错信息会让你一头雾水。注意在 shell 里printf 的格式串最好用单引号包裹。双引号里如果出现$、反引号等字符shell 会先展开而单引号能保证格式串原样传给 printf。当然如果你确实需要把 shell 变量拼进格式串那另说但多数情况下格式串是静态的单引号最安全。3. 场景实操对齐、乱码、颜色、表格一把梭3.1 最基础的“换行输出”先看几个最朴素但每天都在用的写法printf hello world\n printf %s\n hello printf a\tb\n第一行直接输出一行文本。第二行通过%s输出字符串这是脚本里最常见的用法把字符串传给它由 printf 统一加换行。第三行输出a、一个制表符、b。为什么很多资深脚本习惯写printf %s\n $var而不是echo $var原因之一是变量内容不可控。如果变量值以-n或-e开头echo 在不同 shell 里可能把它当成选项吞掉而 printf 的参数不会因为内容开头是-就被当成选项。另一个原因是printf %s\n对变量的解释更严格至少你不会因为变量里带一个\n字面量就多输出一行。3.2 对齐表格与补零直接抄的报表脚本假设你要生成一个用户成绩表名字列左对齐占 10 位成绩占 6 列并保留一位小数printf %-10s %6.1f\n alice 95.5 bob 88.3 christopher 92.0输出效果alice 95.5 bob 88.3 christopher 92.0要注意的是Excel 里那种“列宽固定内容超出自动截断”的行为printf 默认不会做%10s只是“最少占 10 列”如果字符串本身超过 10 个字符会直接撑开。如果你想要截断可以配合精度修饰符但脚本里一般不建议这样做很容易让数据看起来不完整。补零场景也很常见。比如生成带日期前缀的日志文件名月份和日期需要两位year2026 month1 day2 printf %04d-%02d-%02d\n $year $month $day输出2026-01-02。这里的%04d让年份至少占 4 位%02d让月份和日期至少占 2 位不够补零。脚本里做定时任务归档时这个写法几乎是必用招数。3.3 中文乱码先别急着怪 printf热搜词里频繁出现“printf中文乱码”我确实见过很多人把乱码问题甩锅给 printf但 printf 本身基本不会制造乱码。printf 的工作很单纯按格式串把字节输出到标准输出。它不会帮你做编码转换也不会关心内容是 UTF-8 还是 GBK它只是忠实地搬运字节。真正的问题是编码不匹配。我遇到最多的情况有三种终端期望 UTF-8但脚本文件或变量里的内容是 GBK终端当前编码是 GBK但脚本输出的是 UTF-8locale 环境变量不完整程序用了错误的编码处理字符。排查思路很简单。先检查当前区域设置echo $LANG locale如果输出里看不到UTF-8或者LC_ALL被设置成C很多程序的字符处理就可能异常。接着可以用 hexdump 看 printf 到底输出了什么字节printf 中文测试\n | hexdump -C如果看到e4 b8 ad e6 96 87这样以e4、e6开头的长度为三字节的序列说明内容是 UTF-8如果看到d6 d0 ce c4这种两字节序列说明是 GBK。这时候不要改 printf 写法应该去修正终端编码、设置LANGzh_CN.UTF-8或者用iconv -f GBK -t UTF-8做转换。提示还有个很烦的场景是 Windows 上打的 zip 包传到 Linux 解压后文件名乱码。这跟 printf 乱码是同一个原理zip 里的文件名用了 GBKLinux 解压时按 UTF-8 解释。解决办法通常是unzip -O GBK file.zip或者解压后用convmv -f GBK -t UTF-8转换文件名。理解了字节层面的原因这类乱码问题就不会再让你慌。3.4 用 printf 生成文件和网络调试数据printf 重定向到文件是生产环境里非常高频的用法。最简单的printf id,name,score\n1,alice,99\n2,bob,88\n report.csv更多时候你需要把变量插入模板生成配置文件port8080 root/var/www/html printf server {\n listen %s;\n root %s;\n}\n $port $root /tmp/nginx.conf这里关键点有两个。第一格式串用单引号包裹$port才能作为参数传给%s而不是在格式串里被 shell 展开。第二\n和缩进空格都写在格式串里最终生成的配置天然带换行和排版。我用这一招写 CI 脚本里的临时配置已经很多年比 cat 加 heredoc 更轻也比 echo 一行行拼更不容易错。printf 配合 nc 做网络调试也很方便。比如发送一个最简单的 HTTP 请求printf GET / HTTP/1.0\r\nHost: example.com\r\n\r\n | nc target 80因为 HTTP 协议要求行尾是\r\n用 echo 反而不容易写对printf 的\r和\n转义可以直接搞定。类似的往 Redis、Memcached 这类有文本协议的中间件发包调试时printf 也是首选。3.5 加一点颜色脚本瞬间可读长期写脚本的人一定知道绿一行红一行地看着日志容易得多。printf 是输出 ANSI 颜色最稳定的方式printf \033[31m错误信息\033[0m\n printf \033[32m成功信息\033[0m\n\033[31m把后面的文字设为红色\033[0m重置所有属性。数字含义分别是 31 红、32 绿、33 黄、34 蓝。如果你希望把颜色定义成变量复用更稳的写法是用%b去解释转义RED\033[31m NC\033[0m printf %b ${RED}出错${NC}\n这里我不会把$RED直接拼进格式串因为遇到%、\这种字符时格式串有额外语义用%b把颜色变量当参数传进去更安全。4. printf 与其他命令的组合重定向、变量、命令替换4.1 重定向到文件与追加配置printf 和重定向的结合点除了上面提到的生成配置文件还有追加日志。脚本里常见的模式是printf %s %s\n $(date %F %T) 备份完成 backup.log表示追加不覆盖原有内容。如果你要清空文件再写用单箭头。这个逻辑和 echo 一样但 printf 能保证“时间和内容”这两列被格式串控制住日志看起来整整齐齐。还有一个小技巧如果你想生成一个多行文件不需要写一堆 echo直接把所有行塞进一个格式串printf line1\nline2\nline3\n list.txt如果换行多、内容长我会用反斜杠续行拆开写可读性更好printf line1\n\ line2\n\ line3\n list.txt4.2 -v把 printf 结果存进变量Bash 内建 printf 支持-v选项这算一个小众但极其好用的特性。它可以直接把格式化结果赋值给变量免去命令替换开子进程的开销printf -v msg Hello, %s! world echo $msg变量msg会得到Hello, world!。在循环里反复格式化字符串时这个写法比var$(printf ...)省掉很多 fork 开销。比如批量处理几千个文件路径for i in {1..1000}; do printf -v fname file_%03d.txt $i # 用 $fname 继续处理 done性能提升虽然不一定肉眼可见但这种“不需要外部命令、不启动子进程”的思路在追求效率的脚本里值得借鉴。4.3 配合命令替换有个隐形坑很多人喜欢把 printf 的输出用命令替换包起来再往别处传。这种写法本身没问题但你要知道 shell 的命令替换会吞掉末尾的换行符x$(printf hello\n) echo x[$x]输出是x[hello]而不是x[hello\n]。如果一定要保留末尾换行需要在格式串末尾多补一个字符或者别用命令替换直接用-v赋值。另一个隐形坑是把变量直接放在格式串的位置namehello printf $name\n一旦$name里包含%或\字符printf 就会把它当格式串解析很可能输出错误。正确做法是把变量放到参数位置printf %s\n $name这个习惯非常重要尤其是在打印用户输入、文件路径、外部接口返回的数据时。你永远不知道变量里会混进什么奇怪字符先%s挡一层能避免一大半诡异问题。5. 面试高频坑参数消费、求值顺序与格式化字符串5.1 格式串会“吃”完所有参数吗不少 linux 面试题喜欢考 printf 对参数的消费方式。核心规则是格式串会持续使用直到参数列表用完为止。printf %s\n a b c这行会输出三行a、b、c。也就是说%s\n这个格式串被用了三次每次消费一个参数。反向情况更值得注意如果参数不够用缺省参数会被当成空字符串或 0printf 不会因此报错。printf [%s]\n a输出的第二行是什么答案是[]因为格式串一共被用了两次第二次没有参数可消费就当作空字符串输出。这个行为在生成表格时挺容易造成“多出一行空行”的错觉理解原理后就清楚了。5.2 在 C 语言题里printf 还有求值顺序的锅热搜词里有一条“printf n、nn”这其实是 C 语言面试题里的经典坑。很多人拿 shell 的 printf 和 C 的 printf 对比然后问printf(%d %d, n, n)输出什么。这类题目没有标准答案因为同一个表达式里对同一变量进行多次自增在 C 标准里属于未定义行为输出完全取决于编译器的求值顺序。我建议所有学嵌入式、学 C 的朋友不要试图背这种题的结果换个思路理解不要在一个函数调用的多个参数里对同一个变量同时使用也不要依赖求值顺序这是写高健壮性代码的基本素养。而 shell 里的 printf 不存在这种参数求值顺序的坑它在绝大多数实现里按从左到右消费参数写起来反而轻松得多。5.3 为什么不让用户输入直接当格式串安全领域里有一个经典漏洞叫格式化字符串漏洞。C 语言里如果程序员写了printf(user_input)用户输入里带%s、%x、%n这类格式符时printf 会按格式串去读取调用栈上的数据甚至允许通过%n写内存。这种漏洞轻则泄露信息重则可以直接控制程序执行流很多经典提权案例都跟它有关。我不是要教你怎么利用这个漏洞而是想强调防御姿势在所有语言里都不要把外部输入拼进格式化函数的第一个参数。写 C 要用printf(%s, user_input)写 shell 要用printf %s $user_input。这个习惯在写安全类工具、处理不可信数据时尤为重要。5.4 其他冷门但好用的 printf 本领%q是我最常用的调试利器。它能把字符串输出成 shell 可以直接复用的转义形式printf %q\n hello world输出hello\ world之类的形式。调试脚本时如果怀疑变量里藏了空格或者特殊字符用%q打印一遍所有猫腻都会现出原形。这比sed -n l看不可见字符更直观。Bash 4.2 以后的 builtin printf 还支持时间日期格式化格式是%(datefmt)Tprintf %(%Y-%m-%d %H:%M:%S)T\n -1-1表示当前时间输出形如2026-06-03 14:22:31。虽然date命令也能做到但某些嵌入式环境里date的格式不齐全而 Bash 内建 printf 总能给你兜底。6. 排障实战与速查表printf 常见问题一次说清6.1 高频报错与排查清单写脚本久了总会碰到几个固定报错。我整理了一个速查表现象或报错原因处理方式printf: 123: invalid number数字格式符收到了非数字字符串检查变量是否被正确引号包裹先用%s打印看内容printf: %q: invalid format character当前 shell 不是 Bash或调用的是外部 printf确认 shebang 为#!/bin/bash或改用%s中文输出乱码locale、终端、文件字节编码不匹配检查LANG用hexdump -C确认实际字节统一为 UTF-8输出多出空行格式串消费次数多于参数个数数清格式串里的占位符缺省参数会被当作空值变量里有%输出异常变量被放在格式串位置写成printf %s\n $var让%只存在于格式串echo输出-n把 echo 的选项误当普通参数改用printf -- %s\n -n或printf %s\n -n排查时最有效的思路是先确认“printf 收到的参数到底是什么”。我一般会临时执行printf %s\n $var如果尖括号里内容和预期不符问题往往在变量定义或 shell 展开阶段而不是 printf 本身。6.2 几个熟手才常用的兜底技巧最后分享三个我几乎每天都会用到的 printf 小技巧。第一个是快速生成重复字符。比如要在终端输出一条 80 个等号组成的分隔线printf %*s 80 | tr %*s的意思是宽度由下一个参数决定这里是 80第二个参数是一个空字符串所以这行会输出 80 个空格再通过tr把空格替换成等号。同理想要 60 个-把最后面的字符换掉即可。这个写法比for循环加字符串拼接干净得多。第二个是进制转换。printf 可以直接当轻量计算器用把十进制转成十六进制或八进制printf hex: %x\n 255 printf oct: %o\n 10输出hex: ff、oct: 12。反过来想从十六进制字符串转十进制可以用 Bash 的算术展开echo $((16#ff))输出255。这类转换在写网络协议、操作文件权限位时非常常出现记不住的时候翻一下就好。第三个是生成序列号补零。比如一批物品编号要从0001到0100for i in $(seq 1 100); do printf ITEM_%04d\n $i done输出ITEM_0001、ITEM_0002一直到ITEM_0100。%04d的补零机制让编号永远保持四位排序也不会乱。按我自己的经验养成用 printf 代替 echo 这个习惯之后最大的收益不是格式漂亮而是省心。脚本里的输出行为确定、可预期不会因为换了一个 shell 环境就莫名其妙出问题。遇到任何编码或格式异常也不用怀疑是 printf 的问题先去查字节、查 locale、查参数内容基本都能一击命中。