Windows 上可获取真实创建时间,Linux/macOS 的 st_ctime 是元数据变更时间而非创建时间;st_mtime 语义统一可信,st_atime 可能被禁用,权限需用 stat 模块常量解析。

Windows 上能拿到真实创建时间,Linux/macOS 上 os.stat() 返回的 st_ctime 实际是「元数据变更时间」,不是文件创建时间——这点必须提前确认,否则后续逻辑会出错。
用 os.stat() 一次性读取所有基础时间与权限字段
os.stat() 是最轻量、跨平台兼容性最好的方式,它返回一个 os.stat_result 对象,包含全部时间戳和权限位。注意:不同系统对 st_ctime 的定义不同,不能默认它是“创建时间”。
-
st_mtime:修改时间(内容变更),所有系统语义一致,可信 -
st_atime:访问时间(读取文件),可能被系统禁用(如挂载时加noatime) -
st_ctime:Windows = 创建时间;Linux/macOS = 最后一次更改 inode 元数据的时间(比如改权限、改属主) - 权限信息藏在
st_mode里,需用stat模块的常量解码,例如stat.S_ISDIR(st_mode)判断是否为目录
示例:
import os
import stat
<p>path = "/tmp/test.txt"
s = os.stat(path)
print("修改时间:", s.st_mtime) # 时间戳,用 time.ctime(s.st_mtime) 转可读字符串
print("权限模式:", oct(s.st_mode)) # 如 0o100644
print("是否为普通文件:", bool(s.st_mode & stat.S_IFREG))
用 pathlib.Path.stat() 写法更现代但本质相同
pathlib 是 Python 3.4+ 推荐的路径操作方式,Path.stat() 底层仍调用 os.stat(),返回值结构完全一致。好处是链式调用清晰,适合组合路径操作。
立即学习“Python免费学习笔记(深入)”;
- 别指望它修复
st_ctime在 Linux 上不是创建时间的问题 - 若需同时获取路径名和状态,
Path更自然,比如p = Path("/var/log"); p.stat().st_size - 不支持直接解析符号链接目标的状态——要用
p.lstat()获取链接自身元数据,p.stat()默认跟随链接
权限信息别只看 oct(st_mode),要结合 stat 常量判断
直接打印 oct(s.st_mode) 只能看到八进制数字,无法快速识别类型或权限位。Python 的 stat 模块提供了一组掩码常量,用于按位判断。
- 判断文件类型:
stat.S_ISREG(s.st_mode)(普通文件)、stat.S_ISDIR(s.st_mode)(目录)、stat.S_ISLNK(s.st_mode)(软链接) - 判断可执行权限:
s.st_mode & stat.S_IXUSR(用户可执行)、s.st_mode & stat.S_IXGRP(组可执行) - 注意:
st_mode不含 ACL 或扩展属性,如需完整权限需调用subprocess.run(["getfacl", path])(Linux)或subprocess.run(["ls", "-le", path])(macOS)
想跨平台拿到“真正创建时间”?基本做不到,得换思路
没有标准 API 能在 Linux/macOS 上获取文件创建时间(birth time),因为 ext4、XFS 等主流文件系统历史上不存储该字段;APFS(macOS)和 Btrfs(Linux)虽支持,但 Python 标准库未暴露对应接口。
- macOS 可用
subprocess.run(["stat", "-f", "%B", path])读取 birth time(需处理输出和错误) - Linux 若用 Btrfs/XFS 且内核 ≥ 4.11,可用
os.stat(path, follow_symlinks=False)加st_birthtime字段(仅限 CPython 3.12+,且非所有发行版启用) - 更稳妥的做法是:放弃“创建时间”,改用
st_mtime+ 日志/数据库记录首次写入时间
硬要在生产环境强求创建时间,等于把可移植性和维护成本一起扔掉。


















