Python发邮件带附件教程详解

想要通过Python自动发送带附件的邮件？本文为你提供一份详细教程，助你轻松实现这一功能。首先，你需要开启邮箱的SMTP服务并获取授权码。接着，文章将深入讲解如何利用`smtplib`和`email`两大核心模块，配置发件人、收件人、SMTP服务器等信息，并构建包含正文和附件的邮件内容。通过`SMTP_SSL`连接服务器，你就能成功发送邮件。教程还包含了常见问题及注意事项，例如附件路径错误、文件过大、中文文件名编码等问题，并提供批量添加附件的小技巧。掌握这些，让Python邮件发送不再是难题，轻松实现自动发送报表、日志文件等需求。

使用Python发送带附件的邮件，需先开启邮箱SMTP服务并获取授权码。1. 导入smtplib和email模块；2. 配置发件人、收件人、SMTP服务器及授权码等基本信息；3. 使用MIMEMultipart构建邮件内容并添加正文和附件；4. 通过SMTP_SSL连接服务器并发送邮件；5. 处理异常并确保服务器正确关闭。注意事项包括确认文件路径、控制附件大小、处理中文文件名编码问题、选择正确的SMTP端口，并可通过循环批量添加多个附件。

发送带附件的邮件在日常工作中非常常见，比如自动发送报表、日志文件等。Python 中的 smtplib 和 email 模块配合使用，可以轻松实现这个功能。

准备工作：开启邮箱的SMTP服务

在用 Python 发送邮件之前，你需要确保你的邮箱服务商已经开启了 SMTP 服务，并且你获取了对应的授权码（有些平台叫“应用密码”）。
以 Gmail、QQ邮箱、163邮箱为例：

• Gmail：需要开启两步验证后生成应用密码
• QQ邮箱：登录网页版邮箱 -> 设置 -> 账户 -> 开启SMTP服务并获取授权码
• 163邮箱：设置中开启SMTP并设置客户端授权码

拿到授权码之后，就可以开始写代码了。

核心模块介绍：smtplib 与 email

Python 中发送邮件主要依赖两个模块：

• smtplib：负责连接SMTP服务器并发送邮件
• email：构建邮件内容，包括正文、标题、收件人、附件等信息

发送带附件的邮件，关键在于构造 MIMEMultipart 类型的邮件对象，并添加附件部分。

实战步骤：发送带附件的邮件

以下是一个完整的示例流程：

1. 导入所需模块

import smtplib
from email.mime.multipart import MIMEMultipart
from email.mime.text import MIMEText
from email.mime.base import MIMEBase
from email import encoders

2. 配置邮件基本信息

sender = "your_email@example.com"
receiver = "target_email@example.com"
subject = "这是一封带附件的测试邮件"
smtp_server = "smtp.example.com"
smtp_port = 465  # SSL端口
password = "your_password_or_auth_code"

3. 构建邮件内容和附件

msg = MIMEMultipart()
msg['From'] = sender
msg['To'] = receiver
msg['Subject'] = subject

# 添加正文
body = "你好，这是系统自动发送的邮件，请查收附件。"
msg.attach(MIMEText(body, 'plain'))

# 添加附件
filename = "test.txt"  # 替换为你想发送的文件名
attachment = open("path/to/test.txt", "rb")  # 注意路径要正确

part = MIMEBase('application', 'octet-stream')
part.set_payload(attachment.read())
encoders.encode_base64(part)
part.add_header('Content-Disposition',
                f'attachment; filename="{filename}"')

msg.attach(part)

4. 发送邮件

try:
    server = smtplib.SMTP_SSL(smtp_server, smtp_port)
    server.login(sender, password)
    server.sendmail(sender, receiver, msg.as_string())
    print("邮件发送成功")
except Exception as e:
    print(f"发送失败: {e}")
finally:
    server.quit()

常见问题与注意事项

• 附件路径错误：务必确认文件路径是否正确，特别是相对路径和绝对路径的使用
• 文件过大：部分邮箱对附件大小有限制，超过限制会导致发送失败
• 编码问题：中文附件名可能出现乱码，建议统一使用英文命名或手动设置编码
• SMTP端口选择：SSL 端口通常是 465，TLS 是 587，根据邮箱说明选择
• 安全策略限制：部分邮箱可能限制第三方客户端访问，需要在邮箱设置中允许

小技巧：多个附件怎么加？

如果你有多个附件要加，只需要重复上面添加附件的部分即可。例如：

for file in ["file1.txt", "file2.pdf"]:
    part = MIMEBase('application', 'octet-stream')
    part.set_payload(open(file, "rb").read())
    encoders.encode_base64(part)
    part.add_header('Content-Disposition',
                    f'attachment; filename="{file}"')
    msg.attach(part)

这样就能批量添加多个附件了。

基本上就这些。虽然看起来步骤有点多，但只要把结构理清楚，其实并不复杂，只是细节容易忽略。

到这里，我们也就讲完了《Python发邮件带附件教程详解》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于的知识点！