应选'a'模式追加文件，但需先检查zip文件是否存在且非空，否则空文件会触发BadZipFile异常；'w'模式会覆盖原文件，'r'模式不可写入。
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 参数：
立即学习“Python免费学习笔记（深入）”；
- 省略
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 格式本身对路径、编码、流式写入的隐含约束——写完记得用不同解压工具验证，尤其是目标用户用的那款。
