ZipFile.open()不能直接解密ZipCrypto加密文件,因其仅支持AES加密(Python 3.7+),而绝大多数密码ZIP采用ZipCrypto;解密需用extract()/extractall()配合setpassword(bytes型密码),且每次打开新ZIP都须重设密码。

ZipFile.open() 为什么不能直接解密带密码的文件
因为 ZipFile.open() 底层调用的是未解密的原始字节流,它不处理 ZIP 的传统加密(即 ZipCrypto),只支持 AES 加密(需 Python 3.7+ 且压缩包明确用 AES 加密)。绝大多数老式带密码 ZIP 都是 ZipCrypto,而 ZipFile 对 ZipCrypto 的支持仅限于 extract() 和 extractall() 这两个方法——且必须提前用 setpassword() 设置密码。
批量解压时 setpassword() 的作用范围和陷阱
setpassword() 是实例级操作,只对当前 ZipFile 对象后续的 extract() 或 extractall() 生效,不会“记住”密码去处理下一个 ZIP 文件。新手常误以为设一次密码就能循环解压多个文件,结果除第一个外全报错 BadPasswordError。
- 每次打开新 ZIP 文件后,都必须显式调用
zip_file.setpassword(b"your_password") - 密码必须是
bytes类型,不能传字符串;中文密码要先 encode,比如"你好".encode("utf-8") - 如果密码错误,
extractall()会抛出RuntimeError: Bad password for file,不是BadPasswordError(后者是 zipfile.BadPasswordError,需手动 import)
如何安全地批量解压并跳过密码错误的文件
不能靠 try/except 包裹整个 extractall() 就完事——一旦某个文件密码错误,整个解压中断,后续文件全被跳过。正确做法是遍历 filelist,对每个 ZipInfo 单独调用 extract(),并捕获异常。
from zipfile import ZipFile, BadPasswordError
import os
password = b"123456"
for zip_path in ["a.zip", "b.zip", "c.zip"]:
try:
with ZipFile(zip_path) as zf:
zf.setpassword(password)
for info in zf.filelist:
try:
zf.extract(info, path="output/")
except (RuntimeError, BadPasswordError):
print(f"跳过 {zip_path} 中的 {info.filename}:密码错误或加密方式不支持")
except Exception as e:
print(f"打开 {zip_path} 失败:{e}")
注意:RuntimeError 捕获 ZipCrypto 错误,BadPasswordError 捕获部分 AES 场景(Python 3.7+),两者都得覆盖。
立即学习“Python免费学习笔记(深入)”;
遇到“AES encrypted files are not supported”怎么办
这是 Python 原生 zipfile 模块的硬限制:3.6 及更早版本完全不支持 AES 加密 ZIP;3.7+ 支持 AES,但前提是压缩包在创建时明确启用了 AES(而非默认 ZipCrypto),且你用的是 64 位 Python(32 位有兼容问题)。如果你确认是 AES 加密却仍报此错:
- 检查 Python 版本:
python --version必须 ≥ 3.7 - 用
unzip -l -v xxx.zip(Linux/macOS)或 7-Zip 查看压缩包详情,确认加密方式是否真为 “AES-128” 或 “AES-256” - 若确实是 AES 且环境满足,但仍失败,大概率是密码编码问题:AES 要求密码按 UTF-8 编码,且不能含 BOM;尝试
password.encode("utf-8")而非系统默认编码
真正棘手的是混合加密 ZIP(部分文件 ZipCrypto、部分 AES)——zipfile 模块无法处理,只能换用 pyminizip 或调用系统 7z 命令行。


















