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 查询,逻辑大小与分配量仍要区分。




