Python 自动化邮件发送教程：smtplib 和 email 模块

简介

在现代开发中，自动化邮件发送是一个常见需求，例如发送通知、报告或营销邮件。Python 提供了强大的 smtplib 和 email 模块，让这个过程变得简单易行。本教程将带你从零开始，学习如何使用这些模块实现邮件自动化。

为什么学习自动化邮件发送？

• 提高效率：自动处理重复性任务，节省时间。
• 集成应用：轻松将邮件功能嵌入到网站、脚本或应用中。
• 灵活性：支持文本、HTML、附件等多种邮件格式。

准备工作

在开始之前，确保你已安装 Python（推荐版本 3.x）。本教程假设你有基本的 Python 知识，如变量、函数和导入模块。

所需模块

• smtplib：用于通过 SMTP（简单邮件传输协议）发送邮件。
• email：用于构造邮件内容，如主题、正文和附件。

这两个模块都是 Python 标准库的一部分，无需额外安装。

模块概述

smtplib 模块

smtplib 提供了与 SMTP 服务器通信的功能，用于发送邮件。它支持常见的邮件服务，如 Gmail、QQ 邮箱等。

email 模块

email 模块用于创建和解析电子邮件消息。它包括子模块，如 email.mime，可以处理多种邮件类型。

逐步教程

让我们通过一个简单的例子来学习如何发送一封基本邮件。

步骤 1：导入模块

首先，导入必要的模块：

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

• MIMEText：用于创建纯文本或 HTML 邮件正文。
• MIMEMultipart：用于处理多部分邮件，如添加附件。
• MIMEBase 和 encoders：用于处理附件编码。

步骤 2：设置邮件内容

使用 email 模块构造邮件。以下是一个发送纯文本邮件的例子：

# 创建邮件对象
msg = MIMEMultipart()
msg['From'] = 'your_email@example.com'  # 发件人地址
msg['To'] = 'recipient@example.com'  # 收件人地址
msg['Subject'] = 'Python 邮件自动化测试'  # 邮件主题

# 添加邮件正文
body = '你好，这是一封来自 Python 的自动化测试邮件！'
msg.attach(MIMEText(body, 'plain', 'utf-8'))  # 'plain' 表示纯文本，'utf-8' 支持中文

步骤 3：配置 SMTP 服务器并发送邮件

使用 smtplib 连接到邮件服务器并发送邮件。以 Gmail 为例：

# SMTP 服务器设置
gmail_user = 'your_email@gmail.com'  # 你的 Gmail 地址
gmail_password = 'your_app_password'  # 使用应用专用密码，避免使用真实密码

# 创建 SMTP 连接
try:
    server = smtplib.SMTP('smtp.gmail.com', 587)  # Gmail 的 SMTP 地址和端口
    server.starttls()  # 启动 TLS 加密，确保安全
    server.login(gmail_user, gmail_password)  # 登录
    text = msg.as_string()  # 将邮件对象转换为字符串
    server.sendmail(gmail_user, 'recipient@example.com', text)  # 发送邮件
    server.quit()  # 关闭连接
    print('邮件发送成功！')
except Exception as e:
    print(f'发送失败：{e}')

注意：对于 Gmail，你可能需要启用“低安全性应用访问”或使用应用专用密码。其他邮箱服务（如 QQ、163）的 SMTP 设置类似，具体地址和端口请参考其文档。

步骤 4：完整示例代码

以下是发送纯文本邮件的完整脚本：

import smtplib
from email.mime.text import MIMEText
from email.mime.multipart import MIMEMultipart

def send_email(sender, receiver, password, subject, body):
    # 创建邮件
    msg = MIMEMultipart()
    msg['From'] = sender
    msg['To'] = receiver
    msg['Subject'] = subject
    msg.attach(MIMEText(body, 'plain', 'utf-8'))
    
    # 发送邮件
    try:
        server = smtplib.SMTP('smtp.gmail.com', 587)
        server.starttls()
        server.login(sender, password)
        server.sendmail(sender, receiver, msg.as_string())
        server.quit()
        print('邮件发送成功！')
    except Exception as e:
        print(f'错误：{e}')

# 使用示例
send_email(
    sender='your_email@gmail.com',
    receiver='friend@example.com',
    password='your_app_password',
    subject='测试邮件',
    body='这是一封测试邮件。'
)

高级主题

发送 HTML 邮件

要发送 HTML 邮件，只需将 MIMEText 的类型改为 'html'：

html_body = '<h1>Hello!</h1><p>这是一封 HTML 邮件。</p>'
msg.attach(MIMEText(html_body, 'html', 'utf-8'))

添加附件

使用 MIMEBase 添加附件：

# 假设有一个文件 attachment.txt
filename = 'attachment.txt'
attachment = open(filename, '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)
attachment.close()

错误处理和安全性

• 错误处理：使用 try-except 块捕获异常，如网络错误或登录失败。
• 安全性：
  • 不要硬编码密码在代码中。使用环境变量或配置文件存储敏感信息。
  • 启用 SSL/TLS 加密连接（如 starttls()）。
  • 对于生产环境，考虑使用邮件服务商的 API（如 SendGrid）以获得更好性能和安全性。

最佳实践

1. 测试环境：先在测试邮箱上发送邮件，避免误发。
2. 使用虚拟环境：管理项目依赖。
3. 遵守服务条款：确保你的邮件发送行为符合邮件服务商的规定。
4. 优化发送频率：避免被标记为垃圾邮件，可以添加延时或批量发送。

总结

通过本教程，你学习了如何使用 Python 的 smtplib 和 email 模块自动化邮件发送。从基础配置到高级功能如 HTML 和附件，这些知识足以让你在项目中集成邮件功能。

下一步

• 实践：尝试发送不同类型的邮件，如带图片的 HTML 邮件。
• 探索：了解更多 SMTP 选项或使用第三方库如 yagmail 简化流程。
• 集成：将邮件功能添加到你的 Web 应用或自动化脚本中。

祝你学习愉快，Happy coding！

本教程内容为初学者设计，如有疑问，建议查阅官方文档或在线社区获取更多帮助。