Python用zipfile压缩多个文件为Zip包教程

本文深入解析了Python中使用zipfile模块压缩多文件时的五大关键陷阱：如何安全选择文件打开模式（避免BadZipFile异常与意外覆盖）、正确使用write()而非不存在的add_file()并灵活控制归档路径、应对中文文件名在不同解压工具中的乱码问题（需手动设置UTF-8标志或改用兼容命名）、高效处理大文件的流式写入方法（防止内存溢出），以及强调zip格式本身对路径、编码和结构的隐性约束——所有技巧都指向一个核心：生成真正跨平台、稳定可用的Zip包，而非仅通过语法检查。

zipfile.ZipFile() 的 mode 参数选什么才不会覆盖原文件

默认用 'w' 模式打开会清空已有 zip 文件内容，哪怕只是想追加一个新文件。真要追加，得用 'a'；但注意：'a' 模式下如果 zip 文件不存在，会自动创建，可一旦文件存在且为空（0 字节），zipfile 会抛出 BadZipFile 异常——它不认为空文件是合法 zip。

实操建议：

• 先用 os.path.exists() 和 os.path.getsize() 检查目标 zip 是否存在且非空，再决定用 'a' 还是 'w'
• 若明确要重建压缩包，直接用 'w'；若不确定，统一用 'w' 更稳妥，避免异常中断流程
• 'r' 只读模式不能写入，别误用于压缩场景

add_file() 不能直接传路径字符串？得用 write() + arcname

zipfile.ZipFile.add() 并不存在——这是常见误解。真正可用的是 write() 方法，但它对路径处理很“老实”：直接把传入的文件路径当归档内路径，比如 write('data/log.txt') 会在 zip 里生成 data/log.txt，而你可能只想压进去 log.txt。

关键在 arcname 参数：

• 省略 arcname → 保留源路径结构
• 显式指定 arcname='log.txt' → 压缩包内只有一级文件
• 批量压缩时，常用 os.path.basename(filepath) 提取文件名作为 arcname
• 若需保留部分目录层级（如只去掉最外层 src/），可用 os.path.relpath(filepath, start='src')

中文文件名乱码？不是编码问题，是 ZIP 标准限制

Windows 资源管理器解压 Python 生成的 zip 出现中文乱码，通常不是 Python 编码设错了，而是 ZIP 规范本身没强制规定文件名编码——zipfile 默认按 CP437 编码存文件名，而 Windows 解压工具期望 GBK/UTF-8。

绕过办法有限，最实用的是：

• 用 zipfile.ZipInfo 手动构造条目，设置 filename 为 bytes，并开启 flag_bits = 0x800（表示 UTF-8 编码）
• 但注意：旧版 Windows 自带解压工具不识别该 flag，仍会乱码；7-Zip、Bandizip、macOS 归档实用工具支持良好
• 更兼容的做法：压缩前把中文文件名转成英文或拼音，避免依赖编码协商

大文件压缩卡住？别用 write() 直传，改用 open() + writestr()

直接 zipf.write('big_video.mp4') 会把整个文件读进内存再写入 zip 流，几 GB 的文件极易触发 MemoryError 或假死。

正确做法是分块流式写入：

• 用 zipf.open(filename_in_zip, 'w') 获取写入句柄
• 再用普通文件读取方式（open(..., 'rb')）分 chunk_size=8192 读，逐块 .write()
• 这样内存占用恒定，且能配合 tqdm 加进度条
• 注意：此时必须用 ZipInfo 预设 compress_type 和 file_size，否则 zip 结构可能损坏

真正麻烦的不是语法，是 zip 格式本身对路径、编码、流式写入的隐含约束——写完记得用不同解压工具验证，尤其是目标用户用的那款。

今天关于《Python用zipfile压缩多个文件为Zip包教程》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！