Linux stat --printf 怎样按固定格式输出文件属性
来源:17golang原创
时间:2026-11-18 05:59:44 433浏览 收藏
如果只想快速查看文件信息,直接运行 stat path 就够了;但一旦要把结果交给脚本、表格或后续命令处理,默认输出就显得太宽。GNU stat --printf 允许把文件名、类型、大小、权限和时间等属性放进一个固定格式串里,输出内容由你明确选择。
官方文档:https://www.gnu.org/software/coreutils/manual/html_node/stat-invocation.html
--printf和--format都能选择文件属性字段,但--printf会解释反斜杠转义,而且不会自动补最后一个换行。脚本中最重要的两个动作是:格式串固定,换行显式写成\n。
先把 --printf 当成固定输出契约
最小写法是把格式串放在 --printf= 后面,再把一个或多个路径作为参数。常用字段可以组合成一行记录:
# 输出文件名、类型、大小、权限和修改时间,每个路径占一行 stat --printf='%n | %F | %s bytes | %A | %y\n' -- file.txt # 多个路径复用同一个格式串,-- 用来保护以短横线开头的文件名 stat --printf='%n | %F | %s bytes\n' -- file.txt config.yaml
%n 是文件名,%F 是文件类型,%s 是字节数,%A 是符号形式的权限,%y 是最后修改时间。格式串里的竖线只是普通分隔文本;如果要让每个路径各占一行,必须自己加入 \n。

理解 --format 和 --printf 的换行差异
--format 适合人读的普通格式化输出,它会自动追加换行;--printf 更接近“完全由格式串负责输出”,因此不会自动追加强制换行。两者字段占位符相近,但写脚本时不要把它们的换行行为混在一起。
# --format 会自动结束一行,适合快速查看多个路径 stat --format='%n %s' -- file.txt config.yaml # --printf 不自动换行,所以在格式串结尾显式写 \n stat --printf='%n %s\n' -- file.txt config.yaml
如果脚本把多条输出拼接到同一个管道里,漏掉 \n 会让下一条记录紧贴上一条,看起来像字段错位。这个问题不一定会立刻报错,却会破坏下游按行读取的假设。
用字段宽度让数字列更容易比较
GNU stat 的格式说明支持类似 printf 的宽度控制。宽度表示“至少占用多少位置”,不是最大长度;数值不足时会补空格,数值更长时仍会完整输出。
# 用最小宽度对齐字节数,并让文件名保持可读 stat --printf='%-28n %12s bytes %y\n' -- file.txt config.yaml # 用 0 和 # 组合控制八进制权限的展示宽度 stat --printf='%n %#04a\n' -- file.txt
%-28n 让文件名字段至少占 28 个位置,并从左侧开始放值;%12s 让大小字段至少占 12 个位置,默认靠右。权限字段常用 %a 输出八进制权限,配合 # 和 0 可以让前导格式更明确。
路径名很长时,列仍然会向右展开。若需求是截断、脱敏或替换换行符,应该在单独的数据处理层完成,不要误以为格式宽度会自动裁剪内容。
文件名、链接和时间字段怎么选
文件名字段并不只有一个选择。%n 输出传入的名称,%N 会以带引号的形式输出名称,并在符号链接场景中体现链接关系;如果需要把链接当作目标文件读取,可以加 -L,让 stat 解引用符号链接。
# 保留符号链接自身的属性,适合检查链接入口 stat --printf='%n -> %N | %F | %s bytes\n' -- current-link # 显式解引用符号链接,改为查看它指向的目标属性 stat -L --printf='%n | %F | %s bytes\n' -- current-link # 用 Epoch 秒输出修改时间,便于下游按整数比较 stat --printf='%n %Y\n' -- file.txt
%y 适合直接展示带格式的修改时间,%Y 适合脚本按 Epoch 秒做比较。使用 %N 时,输出可能包含引号或转义字符;如果下游需要无歧义地回读路径,应该把它当作引用后的展示值,而不是未经处理的原始字段。
把格式串接入脚本时固定边界
脚本中最值得固定的是字段顺序和记录边界。下面的格式把路径、字节数和修改时间定义成三列,每个输入路径输出一行;格式串不随用户输入变化。
#!/usr/bin/env bash # 固定字段契约:路径、字节数、修改时间;失败时让脚本返回非零状态 set -euo pipefail format='%N\t%s\t%Y\n' for path in "$@"; do # -- 防止以 - 开头的路径被误当成选项 stat --printf="$format" -- "$path" done
这里把输入路径放在独立参数中,而不是拼进格式串。这样格式控制与数据值分离,路径中包含空格时也不会因为 shell 分词而被拆开。set -euo pipefail 让缺失文件等失败尽快暴露;如果业务需要跳过单个坏路径,应在循环内显式处理返回值。

格式串里最常用的字段
| 占位符 | 含义 | 适合场景 |
|---|---|---|
%n | 文件名 | 人读报表或保留输入名称 |
%N | 带引用的文件名,并体现符号链接关系 | 需要降低特殊字符歧义 |
%F | 文件类型 | 区分普通文件、目录和链接 |
%s | 文件大小,单位为字节 | 脚本计算或排序 |
%a / %A | 八进制权限 / 符号形式权限 | 权限清单和人工排查 |
%y / %Y | 格式化修改时间 / Epoch 秒 | 展示时间或做时间比较 |
\n | 换行转义 | 让每个路径形成独立记录 |
字段选择要服从下游用途:给人看的输出可以选 %y 和 %A,机器比较通常更适合 %Y、%s 和稳定分隔符。不要为了“信息完整”把所有字段都塞进一行,字段越多,后续解析和兼容成本越高。
常见问题
为什么 stat --printf 输出多条路径时粘在一起?
因为 --printf 不自动追加最后一个换行。把 \n 写进格式串末尾,例如 --printf='%n\n',每个路径才会形成独立记录。
字段宽度能不能限制文件名最长为 28 个字符?
不能。%-28n 的 28 是最小宽度,短值会补空格,长值仍会完整输出。需要截断时,请先在独立的数据处理步骤中制定规则。
什么时候用 %y,什么时候用 %Y?
%y 方便人直接阅读,%Y 是 Epoch 秒,更适合脚本做数值比较、排序和时间窗口判断。
为什么要在路径前写 --?
它告诉命令后面的内容是操作数而不是选项。文件名可能以短横线开头时,这个边界尤其重要。
总结
用 Linux stat --printf 固定输出文件属性,可以按四个层次来做:先用 %n、%F、%s、%A 和 %y 组合出需要的字段,再在格式串中显式写 \n;接着用宽度改善数字列,用 -L 和 %N 区分符号链接语义;最后把格式串固定在脚本里,让路径作为独立参数传入。这样输出既适合人读,也更容易形成稳定的下游输入契约。
-
426 收藏
-
412 收藏
-
109 收藏
-
386 收藏
-
269 收藏
-
123 收藏
-
211 收藏
-
459 收藏
-
432 收藏
-
文章 · linux | 1天前 | 权限管理 · linux运维 · Linux systemd capabilities 最小权限 file capabilities ambient capabilities266 收藏
-
499 收藏
-
186 收藏
-
265 收藏
-
308 收藏
-
343 收藏
-
337 收藏
-
124 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 立即学习 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 立即学习 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 立即学习 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 立即学习 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 立即学习 485次学习