Linux stat 命令:查看文件大小、权限与四种时间戳

stat 显示文件或目录的大小、权限、所有者、inode(索引节点)、硬链接数、分配块和时间戳等元数据。它比 ls -l 提供更细的状态信息,也能通过格式字符串只输出脚本需要的字段。

本文以 GNU Coreutils 的 stat 为准,说明默认输出、atime/mtime/ctime/Birth、链接、文件系统与格式化用法。BSD/macOS 的同名命令以及某些 shell 内建命令的选项可能不同,使用前先确认实现。

stat 查询什么?

stat 查询文件系统维护的状态,不分析文件内容。将已有文件或目录的路径作为参数即可;下列路径是独立示例,须按本机实际情况调整。

stat report.txt
stat /etc
stat /usr/bin/bash

它与 file 命令 的目的不同:file 依据内容特征推断格式,stat 查看大小、权限、所有权、时间及 inode 等元数据。

基本语法与路径

stat [option] file...

方括号和省略号表示可选参数及多个文件,不是要原样输入的文件名。可一次查询多个路径;空格名称要加引号。

stat file1.txt file2.txt
stat src tests
stat "annual report.pdf"

名称以连字符开头时,用 -- 结束选项解析。

stat -- -sample.txt

用以下命令核对 GNU 实现、版本与选项。若系统未安装 info 或相应文档,最后一行可能不可用,可先查看 --help。

stat --version
stat --help
info '(coreutils) stat invocation'

如何阅读默认输出

普通文件可能得到以下形式;这是说明字段的示意,数值、时间、设备表示方式和字段支持情况会随系统及文件变化。

  File: report.txt
  Size: 4096       Blocks: 8          IO Block: 4096   regular file
Device: 8,1        Inode: 1234567     Links: 1
Access: (0644/-rw-r--r--)  Uid: ( 1000/ user)   Gid: ( 1000/ user)
Access: 2026-09-21 10:15:30.000000000 +0900
Modify: 2026-09-21 10:14:02.000000000 +0900
Change: 2026-09-21 10:14:02.000000000 +0900
 Birth: 2026-09-20 19:42:11.000000000 +0900
字段 含义
File 查询的文件或目录名称。
Size 逻辑大小,单位为字节;目录的值不是子文件总量。
Blocks 已分配的块数;不能直接当作 Size。块单位可用 %B 核对。
IO Block 适合高效输入输出的传输大小提示,不是分配块的单位。
Device 文件所属设备的标识。
Inode 在所属文件系统内标识索引节点的编号。
Links 指向同一 inode 的硬链接数。
Access(权限行) 八进制权限及包含文件类型的符号权限。
Uid、Gid 所有者的用户/组数字 ID 及对应名称。
四种时间行 Access、Modify、Change、Birth 分别对应访问、内容修改、状态改变和创建时间。

ls -l 与 stat 如何选择

比较项 ls -l stat
用途 快速比较多个文件的列表。 查看指定路径的详细状态。
默认时间 通常简要显示修改时间。 区分访问、修改、状态改变及可用的创建时间。
inode 与块 需用附加选项显示部分信息。 默认显示 inode、硬链接数和分配块。
脚本 面向人的列表不宜直接拆列解析。 用 --format 指定所需字段。
文件系统 不直接提供完整文件系统状态。 -f 查询路径所在文件系统。

浏览名称、大小与权限时 ls -l 很方便;需要一个文件的精确字段或自动化输入时,可选 stat。它也不会代替专用工具列出全部扩展属性或完整 ACL(访问控制列表)。

逻辑大小与已分配空间

读取字节大小

普通文件的 Size 表示逻辑字节数,用 %s 可单独读取。以下示例假设对应文件已经存在。

stat -c '%s' disk.img
stat -c '%n: %s bytes' file1 file2

目录的 Size 是目录自身用于保存条目等结构的大小,不是目录树内文件大小总和。若要查看子目录与文件的空间用量,可用 du 命令。

计算分配空间

%b 是分配块数,%B 是每个该类块的字节数。

stat -c 'size=%s blocks=%b block-size=%B' disk.img

分配字节数可按 %b × %B 计算。稀疏文件的逻辑长度可远大于分配量;压缩、共享块等机制也意味着这一数值不等于独占的物理存储成本。不要用 IO Block 代替 %B。

权限、用户和组

八进制与符号权限

%a 输出八进制权限位,%A 输出包含文件类型的符号表示。

stat -c '%a %A %n' script.sh

例如具有相应权限的普通文件可能输出:

755 -rwxr-xr-x script.sh

755 依次表示所有者可读写执行、组和其他用户可读执行。模式位不能完整表达 ACL、安全增强型 Linux(SELinux)、挂载选项等额外限制,不能仅据此保证可以访问。

所有者名称和数字 ID

%U/%G 是用户名/组名,%u/%g 是用户标识 UID/组标识 GID。

stat -c 'owner=%U(%u) group=%G(%g)' report.txt

名称解析依赖本机用户和组数据库,找不到对应名称时可能显示 UNKNOWN 等结果;自动化需稳定标识时,可优先使用数字 ID。

inode 与硬链接

查看 inode 编号

%i 显示文件系统内的 inode 编号。

stat -c '%i %n' report.txt

inode 不是跨文件系统的全局唯一编号。判断路径是否指向同一对象,需结合设备编号(如 %d)和 inode;编号也可能在文件删除后被复用。

查看硬链接数

%h 显示同一 inode 的硬链接数量。示例要求两个路径已经存在,不会创建链接。

stat -c 'inode=%i links=%h name=%n' original.txt copy-link.txt

同一文件系统中,两个不同目录条目若有相同设备编号和 inode,可指向同一对象。符号链接自身有独立的 inode,是否跟随链接会影响比较结果。

atime、mtime、ctime 与 Birth

这些时间记录的事件不同。ctime 是 change time(状态改变时间),不是 creation time(创建时间)。

时间 记录的事件 更新条件与限制
atime 数据最后访问时间。 读取可能更新;noatime、relatime、只读挂载及缓存策略可能使其不逐次更新。
mtime 内容最后修改时间。 写入或改变内容长度;写入通常也更新 ctime。
ctime inode 状态最后改变时间。 权限、所有者、链接数或内容修改;单纯读取不因 atime 变化而更新 ctime。
Birth 文件创建时间。 仅在系统能提供时可见;普通状态变化不会使其变成新的创建时间。

不能假定重命名一定改变文件自身的 ctime:GNU 文档说明这一点未作统一规定;相关父目录的 mtime 和 ctime 会更新。时间也可能被恢复或通过工具设置,不能当作不可篡改的审计证据。

可读时间格式

%x、%y、%z、%w 分别输出四类可读时间,下面的引号内含实际换行。

stat -c 'atime=%x
mtime=%y
ctime=%z
birth=%w' report.txt

无法取得创建时间时,%w 输出 -。显示时区取决于 TZ 环境变量或系统默认设置;比较不同主机前要注意时区。

Unix Epoch 秒数

大写 %X、%Y、%Z、%W 输出自 Unix Epoch(1970-01-01 00:00:00 UTC)起的秒数。

stat -c 'atime=%X mtime=%Y ctime=%Z birth=%W' report.txt

未知 Birth 的 %W 为 0。默认整数秒适合粗略比较,但可能丢失亚秒差异;支持时可用 %.9Y 等指定精度,实际精度仍受文件系统和操作系统限制。

符号链接本身与目标

默认查看链接自身

GNU stat 默认不跟随符号链接,查询链接对象的状态。示例要求 current.log 已是链接。

stat current.log
stat -c '%N | inode=%i | type=%F' current.log

%N 会使用引用形式显示名称,链接还可显示目标;引用风格受 QUOTING_STYLE 影响,不应随意按空格拆分。

用 -L 跟随链接

-L 或 --dereference 改为查询目标文件。

stat -L current.log
stat -L -c '%n | inode=%i | type=%F | size=%s' current.log

断链的目标无法查询,-L 会返回错误。默认模式仍可查询链接自身;选定比较对象后,inode、类型和大小的含义才一致。

按需格式化输出

-c 与 --format

-c/--format 使用指定格式,并为每个操作数自动追加一个换行。

stat -c '%n %s %a %U:%G' file1 file2
stat --format='name=%n type=%F inode=%i' report.txt

用单引号保护格式字符串,避免 shell 提前解释内容。%n 是原始名称,文件名可能含空格或换行;仅选择字段不代表已经解决记录分隔问题。

--printf 与转义

--printf 解析反斜杠转义,但不自动追加换行。所需的 \n 要写入格式。

stat --printf='name=%n\nsize=%s\nmode=%a\n' report.txt

批量机器处理时须同时设计字段和记录分隔。必要时可用 --printf 的 NUL 转义,并配合支持 NUL 的读取程序;不要直接用默认显示文字做可靠协议。

文件模式格式符速查

格式符 含义
%n 原始文件名。
%N 引用的名称,符号链接可包含目标。
%F 文件类型,如普通文件、目录、符号链接。
%s 逻辑大小(字节)。
%b 分配块数。
%B %b 所计块的字节大小。
%a 八进制权限位。
%A 含类型的符号权限。
%u、%g 所有者的数字 UID、GID。
%U、%G 所属用户名称、组名称。
%i inode 编号。
%h 硬链接数。
%m 路径所属挂载点。
%x、%X 访问时间:可读格式、Epoch 秒。
%y、%Y 内容修改时间:可读格式、Epoch 秒。
%z、%Z 状态改变时间:可读格式、Epoch 秒。
%w、%W 创建时间:可读格式、Epoch 秒;未知为 -、0。
%C 可用时的 SELinux 安全上下文。

文件系统状态

-f 模式

-f/--file-system 查询指定路径所在的文件系统,而不是文件自身;此选项隐含 -L,会跟随链接。示例中的路径必须实际存在。

stat -f /
stat --file-system /home

可查看文件系统类型、总块数、空闲块、文件节点数和文件名最大长度。某些文件系统可能不提供有意义的节点数量,不能把缺失值当作真实容量。

文件系统专用格式符

-f 模式使用另一组格式符:%T 是类型名称,%b 是总数据块数,%a 是非超级用户可用块数,%S 是用于块计数的基本块大小。

stat -f -c 'type=%T total=%b available=%a block-size=%S' /

例如总字节容量按 %b × %S 计算,可用字节按 %a × %S 计算;不要沿用文件模式中 %b/%B 的解释。人工阅读磁盘用量时 df -h 可能更方便。

远程属性与缓存

系统支持时,--cached=MODE 可在属性新鲜度和查询效率之间选择。它不是关闭文件内容缓存的通用开关。

模式 作用
default 交由底层文件系统决定缓存行为。
always 若已有缓存属性则读取缓存,结果可能不是最新。
never 与最新文件系统属性同步,可能增加远程延迟,并触发自动挂载。
stat --cached=never /mnt/remote/report.txt

示例假设 /mnt/remote/report.txt 已存在。具体效果依赖内核、网络文件系统(NFS)等文件系统和挂载方式;先用 stat --help 确认本机支持,不要据此宣称跨客户端绝对一致。

Bash 脚本示例

按文件大小分支

以下是独立脚本,先将 path 改为已有普通文件。100 MiB 等于 104857600 字节,判断使用严格大于,因此恰好 100 MiB 不打印提示。exit 会结束脚本。

path='archive.tar'
[ -f "$path" ] || exit 1
size=$(stat -c '%s' -- "$path") || exit 1

if [ "$size" -gt 104857600 ]; then
  printf '%s\n' '文件大于 100 MiB。'
fi

本例只读取元数据,不创建或解包 archive.tar。检查与后续使用之间文件仍可能变化,预检查不能消除竞态。

比较修改时间

先准备 file-a 与 file-b。只有两次 stat 都成功后才进行数值比较,避免把错误产生的空值拿来计算。

left_mtime=$(stat -c '%Y' -- file-a) || exit 1
right_mtime=$(stat -c '%Y' -- file-b) || exit 1

if [ "$left_mtime" -gt "$right_mtime" ]; then
  printf '%s\n' 'file-a 的修改时间更晚。'
fi

这里按整数秒比较,同一秒内的修改可能被视为相同。备份和部署不能只依赖时间戳:时钟偏差、恢复的时间与并发写入都会影响判断,必要时结合校验和或版本。

常用命令

命令 用途
stat file 显示该实现默认提供的文件状态。
stat -L link 查看符号链接目标。
stat -c '%s' file 大小(字节)。
stat -c '%a %n' file 八进制权限与名称。
stat -c '%U:%G' file 所属用户和组。
stat -c '%i %h %n' file inode、链接数和名称。
stat -c '%y' file 可读修改时间。
stat -c '%Y' file Epoch 秒格式的修改时间。
stat -f path 路径所在文件系统。
stat -t file 简洁格式;字段集合随模式和实现变化,名称仍需妥善处理。

使用边界与排错

ctime 不代表创建

修改权限或内容都可能改变 ctime。需要创建时间应查询 Birth;未知时不要把 ctime 填作创建时间。

Birth 与 atime 可能不符合直觉

Birth 依赖文件系统、内核及查询接口。atime 也可能因 noatime、relatime、缓存或只读策略不逐次更新;“没有变化”不能证明无人读取。

检查错误与输出协议

路径不存在、上级目录无搜索权限、断链目标缺失等都可能导致查询失败。GNU stat 成功返回 0,失败返回非零;先检查状态,再使用输出值。不要为了绕过错误直接提权,应先核对路径、对象和实际所需权限。默认文字受版本与区域设置影响,脚本应明确字段、分隔和语言条件。

常见问答

怎样只查看八进制权限?

使用 stat -c '%a' -- 文件名;需要名称时在格式中加 %n。

mtime 与 ctime 有何不同?

mtime 记录内容修改;ctime 记录包含权限、所有者、链接数和内容变化的状态改变。ctime 不是创建时间。

为什么 Birth 是连字符?

系统未提供创建时间,或 stat 无法取得。%w 表示为 -,%W 表示为 0。

目录的 Size 是内部文件总大小吗?

不是。它反映目录自身结构的大小;目录树空间用量可用 du -sh 查询,逻辑大小与分配量仍要区分。

参考资料