zipfile.ZipFile() 不能直接遍历文件内容,因其仅加载中央目录元数据;需用 open() 获取流对象逐块读取,避免 read() 全量加载内存。

zipfile.ZipFile() 为什么不能直接遍历所有文件内容
因为 ZipFile 对象默认只读取压缩包的中央目录(central directory),不自动解压任何文件。调用 namelist() 或 infolist() 只返回文件名或元数据,真正读取内容必须显式调用 open() 或 read() —— 而这一步才触发解压逻辑,但仍是内存内解压,不落盘。
常见误区是以为 for file in zipf.filelist: 就能拿到内容,其实 file 是 ZipInfo 实例,只有路径、大小、时间戳等信息,没有数据本身。
-
ZipInfo.filename可安全用于判断路径、过滤后缀(如.py或.json) - 若需内容,必须对每个匹配的
ZipInfo调用zipf.open(info).read() - 注意:
zipf.open()返回的是类似io.BytesIO的流对象,不能直接用字符串方法处理,需先.decode()(如果是文本)
如何避免一次性加载整个文件到内存
对大文件(比如几百 MB 的日志或 CSV),用 read() 会把全部内容载入内存;正确做法是用 open() 返回的流对象逐块读取。
例如处理一个压缩包里的大文本文件:
立即学习“Python免费学习笔记(深入)”;
with zipfile.ZipFile('data.zip') as z:
for info in z.filelist:
if info.filename.endswith('.log'):
with z.open(info) as f: # 不解压到磁盘,但返回可读流
for line in f: # 自动按行迭代(底层缓冲,不爆内存)
if b'ERROR' in line:
print(info.filename, line[:50].strip())- 不要写
f.read().splitlines(),这会强制加载全文本 -
z.open()支持__iter__,所以可直接for line in f - 二进制模式下,
line是bytes,需注意编码;若确定是 UTF-8,可用io.TextIOWrapper(f, encoding='utf-8')包一层
遇到“Bad magic number”或“Not a ZIP file”错误怎么办
这类报错通常不是 ZIP 格式问题,而是你传了错误路径、文件被截断、或用了不支持的压缩方式(如 ZIP64 + 某些旧 Python 版本)。
- 先确认文件真实存在且完整:
os.path.getsize('xxx.zip') > 0 - 检查是否被其他进程占用(尤其 Windows 下编辑器可能锁住文件)
- 某些 ZIP 用了 AES 加密,
zipfile默认不支持,会报Bad CRC-32或静默跳过——此时需用pyminizip或zipfile36等第三方库 - 如果 ZIP 由 macOS 的“归档实用工具”生成,有时含冗余资源分支(
__MACOSX/),不影响读取,但namelist()会包含它们,记得过滤
需要同时读多个文件时,别重复打开 ZipFile
每次 zipfile.ZipFile(...) 都会重新解析中央目录,开销不小;频繁 open() 单个文件也不会额外加重 IO——因为 ZIP 是随机访问结构,定位某文件只需查表+偏移读取。
- 把
ZipFile当作上下文管理器用一次,内部完成所有操作 - 避免写成:
for f in names: with ZipFile(...) as z: z.open(f)—— 这样每轮都重解析 ZIP 头 - 如果要并发读(比如多线程处理不同文件),注意
ZipFile实例不是线程安全的;应每个线程单独实例化,或用threading.Lock包裹z.open()
流式处理的关键就两点:别调 read(),别反复构造 ZipFile。剩下的只是按需拿 ZipInfo、再用 open() 流式读——它天然支持,不用额外装库,也不用临时解压目录。


















