登录
推荐 文章 Go 技术 课程 下载 专题 AI
首页 >  文章 >  linux

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。

文件路径经过 stat --printf 映射到文件名、类型、大小、权限和修改时间字段的静态结构图
图1:结构说明图,展示 stat --printf 如何把文件对象映射到选定属性字段;不是截图或运行证据。

理解 --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 让缺失文件等失败尽快暴露;如果业务需要跳过单个坏路径,应在循环内显式处理返回值。

输入路径、stat --printf 格式契约、显式换行、固定列记录和下游读取层的静态关系图
图2:结构说明图,展示 stat --printf 的字段契约与下游读取边界;不代表某次命令的真实输出。

格式串里最常用的字段

占位符含义适合场景
%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 区分符号链接语义;最后把格式串固定在脚本里,让路径作为独立参数传入。这样输出既适合人读,也更容易形成稳定的下游输入契约。

声明:本文转载于:17golang原创 如有侵犯,请联系study_golang@163.com删除
相关阅读
更多>
最新阅读
更多>
课程推荐
更多>