Python zipfile不支持创建加密ZIP，仅支持读取；需用pyminizip生成ZipCrypto加密ZIP，再通过smtplib配合MIMEApplication发送，并严格校验ZIP完整性、密码有效性及邮件大小。
zipfile加密为什么不能直接用password参数
Python标准库zipfile的ZipFile.write()不支持密码保护——这是最常踩的坑。你调用setpassword()后写入文件，解压时仍提示“无密码”，因为zipfile仅支持读取加密ZIP，**不支持创建带密码的ZIP**（AES或ZipCrypto）。真正能生成可解压密码ZIP的，只有zipfile配合pyminizip或系统命令，但后者跨平台差。推荐用pyminizip：它底层调用zlib+minizip，能生成Windows/macOS/Linux通用的ZipCrypto加密ZIP（注意：不是AES，但兼容性好）。
安装：
pip install pyminizip
关键点：
-
pyminizip.compress()的password参数必须是字符串，不能为None或空串 - 压缩级别建议用
5（平衡速度与体积），9在小文件上几乎没收益反而卡住 - 源路径必须是文件或目录，不能是
Path对象——需先转str() - 目标ZIP路径不能已存在，否则抛
OSError: [Errno 17] File exists
如何用smtplib发带附件的加密ZIP邮件
邮件发送本身不难，但附件加密ZIP容易失败，核心原因是MIME类型识别错、二进制读取方式不对、或附件名含中文导致乱码。正确做法是：用email.mime.application.MIMEApplication显式指定application/zip类型，并以rb模式打开ZIP文件。
立即学习“Python免费学习笔记（深入）”；
实操要点：
- SMTP服务器地址和端口要匹配服务商——Gmail用
smtp.gmail.com:587，Outlook用smtp-mail.outlook.com:587，国内企业邮箱常为smtp.exmail.qq.com:465（SSL） - 发件人邮箱必须开启“SMTP服务”且使用“应用专用密码”（Gmail/Outlook），不能直接用登录密码
- 附件名建议用ASCII字符（如
report_202405.zip），避免中文；若必须用中文，需对filename参数做Header编码，否则部分客户端显示为unknown.bin - 邮件正文别用
text/plain硬塞HTML标签，应统一用MIMEText(..., 'html')并确保UTF-8编码
自动加密分发流程中三个关键校验点
跳过校验，90%的失败发生在“以为发出去了，其实收件人打不开”。必须在发送前做三件事：
- 用
pyminizip.compress()生成ZIP后，立即用zipfile.ZipFile(...).testzip()检查是否损坏——返回None才表示可正常读取结构 - 用
zipfile.ZipFile(..., 'r')尝试用相同密码extractall()到临时目录，验证密码是否真有效（RuntimeError: Bad password for file说明密码错或ZIP未加密） - 构造邮件对象后，调用
msg.as_string()前，打印len(msg.as_string())，确认大小没超邮箱附件限制（Gmail上限25MB，超了得拆包或换云链接）
这三个步骤加起来不到10行代码，但省去后续两小时排查。
密码管理与安全边界在哪里
把密码写死在脚本里（比如password="123456"）等于没加密。生产环境必须分离密钥：
- 密码从环境变量读取：
os.getenv("ZIP_PASSWORD", "")，启动前用export ZIP_PASSWORD=xxx - 邮件SMTP密码同理，绝不可出现在Git历史中——加
.gitignore忽略.env，再用python-dotenv加载 - 如果分发对象多，别用同一密码；可用
secrets.token_urlsafe(8)为每个收件人生成唯一密码，并通过另一通道（如企业微信/短信）单独发送 - 注意：ZipCrypto加密本身较弱（易被暴力破解），仅适用于防误点开；敏感数据必须用GPG或AES-256加密后再打包
自动分发链越短越可靠——ZIP生成、密码注入、邮件组装、发送，四步之间不要引入中间文件缓存，避免权限/磁盘满/并发冲突问题。
