最直接获取文件字节数用 os.path.getsize(),它轻量可靠、底层调用 stat,但仅适用于普通文件,需先用 os.path.isfile() 判断;若还需修改时间等元数据,应改用 os.stat() 或 pathlib.Path.stat() 一次性读取。

用 os.path.getsize() 拿文件字节数最直接
只要不是符号链接或需要跨平台一致性校验,os.path.getsize() 是获取文件大小最轻量、最可靠的方式。它底层调用系统 stat,返回的是文件内容实际占用的字节数(不包括元数据),和 ls -l 显示的大小一致。
常见错误是传入目录路径——它会抛出 IsADirectoryError;或者传入不存在的路径,抛出 FileNotFoundError。务必先用 os.path.isfile() 做兜底判断。
- 只对普通文件有效,对目录、设备文件、管道等会失败
- 不触发文件读取,性能几乎为零,比打开再
seek(0, 2)快得多 - Windows 下对某些重解析点(如符号链接)可能返回目标文件大小,而非链接本身
import os
if os.path.isfile("data.bin"):
size = os.path.getsize("data.bin") # 返回 int,单位字节
print(f"大小:{size} 字节")用 os.stat() 一次性读取大小 + 修改时间
如果既要大小又要最后修改时间(mtime),别分两次调用 os.path.getsize() 和 os.path.getmtime() —— 这会触发两次系统调用,且在文件被并发修改时可能拿到不一致的时间戳与大小。
os.stat() 一次返回完整元数据,st_size 和 st_mtime 都来自同一内核结构体,天然同步。注意 st_mtime 是时间戳(秒级浮点数),需用 datetime.fromtimestamp() 转成可读格式。
立即学习“Python免费学习笔记(深入)”;
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac,无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启:辅助功能 + 屏幕录制权限
-
st_mtime是最后写入时间,不是创建时间(Windows 上st_ctime是创建时间,Linux 上是状态变更时间) - 权限、硬链接数、inode 等字段也一并拿到,适合做批量文件分析
- 遇到权限不足的文件(如 /proc 下某些条目),会抛出
PermissionError
import os
from datetime import datetime
try:
st = os.stat("config.json")
size = st.st_size
mtime = datetime.fromtimestamp(st.st_mtime)
print(f"{size} 字节,最后修改于 {mtime}")
except (FileNotFoundError, PermissionError):
pass为什么不用 pathlib.Path.stat()?它其实更推荐
Python 3.4+ 的 pathlib 并非“替代品”,而是更现代、更安全的封装。它的 stat() 方法行为和 os.stat() 完全一致,但路径对象自带存在性检查和类型语义,能减少手误。
容易踩的坑是直接对 Path 对象调用 .stat() 却没处理异常——它不会静默失败,仍会抛出 FileNotFoundError。另外,Path 默认不解析符号链接,要拿目标文件属性得用 .lstat()(类似 os.lstat())。
-
Path("log.txt").stat().st_size比os.path.getsize("log.txt")多一次对象构造开销,但可忽略 - 支持链式操作,比如
Path("src").rglob("*.py")后统一.stat(),逻辑更清晰 - Windows 路径分隔符自动处理,避免
"C:\temp\file"类硬编码
from pathlib import Path
p = Path("archive.zip")
if p.is_file():
st = p.stat()
print(f"大小:{st.st_size}, 修改时间:{st.st_mtime}")别用 open().seek(0, 2) 获取大小
有人用 f.seek(0, 2); f.tell() 模拟 getsize(),这在小文件上看似可行,但问题明显:它必须打开文件,触发 I/O,还可能因文件权限、锁、特殊设备(如 /dev/zero)而失败或阻塞。
更隐蔽的问题是,对某些文件系统(如 NFS 或某些容器挂载),seek(0, 2) 可能返回错误结果;对压缩包或数据库文件这类“逻辑文件”,seek 得到的是底层存储大小,不是解压后/逻辑大小。
- 纯属多此一举,没有比
os.path.getsize()更简单可靠的方案 - 若文件正被写入中,
seek(0, 2)可能返回未刷盘的数据长度,而stat()返回的是当前已落盘大小 - Python 3.8+ 的
os.stat()支持follow_symlinks=False参数,控制是否解析链接,open()方案做不到这点
文件大小和修改时间本质是 inode 层面的属性,绕过系统接口自己推算只会引入不确定性。真正要注意的,是路径是否存在、是否有权限、以及你到底想查“链接本身”还是“链接指向的目标”——这三个点没理清,后面所有操作都可能偏航。

















