登录
首页 >  文章 >  python教程

Python获取文件大小与创建时间方法

时间:2026-05-14 18:32:49 322浏览 收藏

本文深入解析了Python中使用os.stat()高效获取文件大小与时间戳的正确实践,强调一次性读取元数据以减少系统调用开销,并重点揭示了Windows与Linux/macOS下st_ctime语义的根本差异——前者是真正的创建时间,后者实为状态变更时间,跨平台误用极易导致逻辑错误;同时详解了时间戳必须经time.localtime()转换才能格式化、文件大小需按1024进制换算为KiB/MiB等可读单位等关键细节,辅以实用代码示例和避坑指南,帮你避开高发陷阱,写出健壮、可移植的文件元数据处理代码。

Python如何获取文件的大小及创建时间属性_调用os.stat与time模块格式化输出

os.stat() 一次性读取文件元数据,别反复调用

os.stat() 返回一个包含所有基础属性的 stat_result 对象,里面就有文件大小(st_size)、创建时间(st_ctime)、修改时间(st_mtime)和访问时间(st_atime)。Windows 下 st_ctime 是创建时间;Linux/macOS 下它其实是「状态变更时间」(比如权限改了、硬链接数变了),不是创建时间——这点常被误用。

实操建议:

  • 直接传入路径调用 os.stat("path/to/file"),避免对同一文件多次调用 os.path.getsize()os.path.getctime(),减少系统调用开销
  • 检查路径是否存在且为文件:先用 os.path.isfile(),否则 os.stat() 会抛 OSError
  • 注意编码问题:若路径含中文或特殊字符,确保 Python 脚本文件本身以 UTF-8 保存,且 Python 3 环境下一般无问题;Python 2 则需手动 decode

格式化时间戳必须用 time.localtime() 再传给 time.strftime()

os.stat() 拿到的 st_ctime 是秒级浮点数时间戳(如 1715829341.123456),不能直接传给 strftime()。必须先转成 struct_time 对象。

常见错误现象:

  • 直接写 time.strftime("%Y-%m-%d", stat.st_ctime) → 报 TypeError: argument must be a time.struct_time
  • datetime.fromtimestamp() 也可以,但引入 datetime 模块属于“重武器”,纯 time 就够用

正确写法示例:

import os
import time

s = os.stat("example.txt")
ctime = time.strftime("%Y-%m-%d %H:%M:%S", time.localtime(s.st_ctime))
size = s.st_size

Windows 和 Linux 的创建时间语义不同,别默认跨平台等价

这是最容易踩的坑。Windows 文件系统(NTFS)原生支持创建时间(st_ctime),而 ext4、APFS 等多数 Unix-like 文件系统不存储创建时间,st_ctime 实际是最后元数据变更时间(chown/chmod/touch -c 等触发)。所以你在 Linux 上看到的“创建时间”可能比修改时间还晚。

使用场景判断:

  • 只在 Windows 环境部署?可以放心用 st_ctime 表示创建时间
  • 需要跨平台一致性?放弃“创建时间”,改用 st_mtime(最后修改时间)更可靠
  • 真要模拟创建时间?可结合文件名中的时间戳、Git 提交时间、或首次写入时记录到 sidecar 文件中

输出大小时记得单位换算和可读性处理

st_size 单位永远是字节,直接打印 123456789 对人不友好。常见做法是按 1024 进制缩放并加单位。

实操建议:

  • math.floorround 控制小数位,避免 1.23456789 MB 这种冗余显示
  • 区分二进制(KiB/MiB)和十进制(KB/MB):存储厂商标称用十进制(1 KB = 1000 B),但系统常用二进制(1 KiB = 1024 B)。Python 社区倾向用 KiB/MiB,避免歧义
  • 简单封装函数即可复用:
def format_size(n):
    for unit in ["B", "KiB", "MiB", "GiB"]:
        if n 
<p>真正难的是在没有完整文件系统支持的场景下解释“创建时间”——它从来就不是个普适概念。</p><p>终于介绍完啦!小伙伴们,这篇关于《Python获取文件大小与创建时间方法》的介绍应该让你收获多多了吧!欢迎大家收藏或分享给更多需要学习的朋友吧~golang学习网公众号也会发布文章相关知识,快来关注吧!</p>
资料下载
相关阅读
更多>
最新阅读
更多>
课程推荐
更多>