发送带附件邮件必须用MIMEMultipart('mixed')构造消息体,附件需以rb模式读取、用MIMEApplication包装并设正确subtype,通过msg.attach()添加;SMTP须先starttls()再login(),Gmail需应用专用密码,端口选587配STARTTLS或465配SMTP_SSL。

直接发带附件的邮件,smtplib 本身不处理附件,必须配合 email 模块构造 MIMEMultipart 消息体;否则附件会变成乱码或根本收不到。
用 MIMEMultipart 替代 MIMEText
纯文本邮件用 MIMEText 就够了,但加附件必须升级到 MIMEMultipart('mixed') —— 它是容器,能同时装正文和附件。
常见错误:把附件直接塞进 MIMEText 的 set_payload(),结果附件内容被 Base64 编码两次,收件方打不开。
-
MIMEMultipart('alternative')仅用于 HTML + 纯文本双版本正文,不能加附件 -
MIMEMultipart('related')用于内嵌图片(如<img src="cid:xxx" alt="如何在Python中发送带有附件的电子邮件_利用smtplib与email模块" >),也不适合普通附件 - 附件必须作为独立 part 添加,调用
msg.attach(part),不是拼字符串
附件要读成二进制并设置正确 MIME 类型
附件内容必须以 rb 模式打开,再用 MIMEApplication 或 MIMEBase 包装;用 str 或 text 模式读会导致编码错乱。
立即学习“Python免费学习笔记(深入)”;
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac,无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启:辅助功能 + 屏幕录制权限
示例:发送一个 Excel 文件
with open('/path/to/report.xlsx', 'rb') as f:
part = MIMEApplication(f.read(), _subtype='vnd.openxmlformats-officedocument.spreadsheetml.sheet')
part.add_header('Content-Disposition', 'attachment', filename='report.xlsx')
msg.attach(part)
- 不要硬写
application/octet-stream,尽量匹配真实类型(查python-magic或文件扩展名映射表) -
filename必须在Content-Disposition头里指定,否则 Outlook 等客户端可能显示为 “无标题” - 中文文件名需用
encode('utf-8').decode('latin-1')转义,或改用Header类编码(更稳妥)
SMTP 认证与 TLS 设置容易漏掉关键步骤
很多公司邮箱(如 Gmail、Outlook)强制要求 STARTTLS,且密码不能直接填账户密码——得用应用专用密码或开启 SMTP 权限。
典型失败现象:smtplib.SMTPAuthenticationError 或连接后立即断开。
- 先调
server.starttls(),再server.login();顺序反了会报SMTPSenderRefused - Gmail 需在 Google 账户中开启“两步验证”并生成“应用专用密码”,填在
login()第二个参数 - 端口别混淆:
587(STARTTLS)和465(SSL)行为不同,smtplib.SMTP_SSL()才对应 465 - 记得
server.quit(),否则连接堆积可能触发风控
最常被忽略的是附件的 Content-Transfer-Encoding 头——MIMEApplication 默认设为 base64,没问题;但若手动用 MIMEBase,忘了调 encoders.encode_base64(part),附件就发不出去。

















