Python 发送邮件的三种实用方案：smtplib、zmail 与 yagmail

闻溪

发布时间：2026-10-14| 7人浏览过

原创

本文总结了 Python 中发送电子邮件的三种主流方式。首先介绍标准库 smtplib 的手动构建邮件体流程，随后对比两款简化库 zmail 和 yagmail。zmail 支持自动处理协议与端口，yagmail 则以极简代码实现发送。文章提供了基于 126 邮箱的完整配置示例及代码片段，帮助开发者根据项目需求选择最合适的邮件发送方案。

Python 发送邮件概述与前置准备

1. 前言

电子邮件作为正式且规范的沟通渠道，在各类日常办公场景中应用广泛。

Python 语言内置了对 SMTP 协议的支持，允许开发者直接发送纯文本、富文本以及 HTML 格式的邮件。

本文将详细介绍利用 Python 实现邮件发送的三种不同方法。

2. 准备

以 126 邮箱为例，在编写代码前，用户需登录邮箱后台开启 SMTP 服务。

随后，手动生成并保存一个授权码。

后续代码中将使用账号、授权码以及服务器地址这三个关键信息来建立与邮箱服务器的连接并完成登录验证。

使用标准库 smtplib 发送邮件

3. 方式一：smtplib

smtplib 是 Python 标准库的一部分，无需额外安装，直接导入即可使用。

首先，利用邮箱账号、授权码及服务器地址初始化 SMTP 实例，并建立连接。


def __init__(self):
  # 初始化
  self.smtp = smtplib.SMTP()

  # 连接邮箱服务器地址
  self.smtp.connect('smtp.126.com')

  # 加入主题和附件，邮件体
  self.email_body = MIMEMultipart('mixed')

  # 发件人地址及授权码
  self.email_from_username = '**@126.com'
  self.email_from_password = '授权码'

# 登录
self.smtp.login(self.email_from_username, self.email_from_password)

接着，将收件人列表、邮件主题、正文内容以及附件路径和文件名整合到邮件体对象中。


def generate_email_body(self, email_to_list, email_title, email_content, attchment_path, files):
  """
  组成邮件体
  :param email_to_list:收件人列表
  :param email_title:邮件标题
  :param email_content:邮件正文内容
  :param attchment_path:附件的路径
  :param files:附件文件名列表
  :return:
  """
  self.email_body['Subject'] = email_title
  self.email_body['From'] = self.email_from_username
  self.email_body['To'] = ",".join(email_to_list)

  for file in files:
    file_path = attchment_path + '/' + file
    if os.path.isfile(file_path):
      # 构建一个附件对象
      att = MIMEText(open(file_path, 'rb').read(), 'base64', 'utf-8')
      att["Content-Type"] = 'application/octet-stream'
      att.add_header("Content-Disposition", "attachment", filename=("gbk", "", file))
      self.email_body.attach(att)

  text_plain = MIMEText(email_content, 'plain', 'utf-8')
  self.email_body.attach(text_plain)

随后，调用 SMTP 实例的发送方法将邮件发出。


 # 收件人列表
email_to_list = ['收件人1地址','收件人2地址']

# 发送邮件
# 注意：此处必须同时指定发件人与收件人，否则会当作垃圾邮件处理掉
self.smtp.sendmail(self.email_from_username, email_to_list, self.email_body.as_string())

发送完成后，调用退出方法关闭服务连接。


def exit(self):
  """
  退出服务
  :return:
  """
  self.smtp.quit()

使用 zmail 简化邮件处理

4. 方式二：zmail

Zmail 库的设计初衷是简化邮件处理流程。

使用 Zmail 进行邮件收发操作便捷，无需手动指定服务器地址、端口号或协议类型，它能自动创建 MIME 对象及头文件。

注意：Zmail 仅兼容 Python3，不支持 Python2 环境。

首先，通过 pip 安装依赖库。


# 安装依赖库
pip3 install zmail

然后，使用邮箱账号和授权码创建一个邮箱服务对象。


class ZMailObject(object):

  def __init__(self):
    # 邮箱账号
    self.username = '**@126.com'

    # 邮箱授权码
    self.authorization_code = '授权码'

    # 构建一个邮箱服务对象
    self.server = zmail.server(self.username, self.authorization_code)

接着，将邮件主题、正文内容及附件路径封装进字典，构成邮件主体。


# 邮件主体
mail_body = {
    'subject': '测试报告',
    'content_text': '这是一个测试报告', # 纯文本或者HTML内容
    'attachments': ['./attachments/report.png'],
}

最后，调用 send_mail() 函数即可完成发送。


# 收件人
# 可以指定一个人，字符串；也可以是多个人，列表
mail_to = "收件人1"

# 发送邮件
self.server.send_mail(mail_to, mail_body)

使用 yagmail 实现极简发送

5. 方式三：yagmail

yagmail 仅需寥寥数行代码即可实现邮件发送功能。

相较于 zmail，yagmail 的实现方式更为简洁优雅。

首先，安装依赖库。


# 安装依赖库
pip3 install yagmail

然后，通过提供账号、授权码和服务器地址来连接邮箱服务器，获取服务对象。


import yagmail

# 连接服务器
# 用户名、授权码、服务器地址
yag_server = yagmail.SMTP(user='**@126.com', password='授权码', host='smtp.126.com')

接着，利用 send() 函数执行发送操作。


# 发送对象列表
email_to = ['**@qq.com', ]
email_title = '测试报告'
email_content = "这是测试报告的具体内容"
# 附件列表
email_attachments = ['./attachments/report.png', ]

# 发送邮件
yag_server.send(email_to, email_title, email_content, email_attachments)

邮件发送完毕后，关闭连接以释放资源。