Python smtplib模块详解：发送邮件

使用 Python 的 smtplib 模块来发送邮件非常简单，大部分底层的处理都由 smtplib 进行了封装，开发者只需要按照如下 3 步来发送邮件即可：

1. 连接 SMTP 服务器，并使用用户名、密码登录服务器。
2. 创建 EmailMessage 对象，该对象代表邮件本身。
3. 调用代表与 SMTP 服务器连接的对象的 sendmail() 方法发送邮件。

下面程序按照上面步骤示范了如何发送邮件：

import smtplib
from email.message import EmailMessage

# 定义SMTP服务器地址:
smtp_server = 'smtp.qq.com'
# 定义发件人地址
from_addr = 'kongyeeku@qq.com'
# 定义登录邮箱的密码
password = '123456'
# 定义收件人地址:
to_addr = 'kongyeeku@163.com'

# 创建SMTP连接
#conn = smtplib.SMTP(smtp_server, 25)
conn = smtplib.SMTP_SSL(smtp_server,465)
conn.set_debuglevel(1)
conn.login(from_addr, password)            #①
# 创建邮件对象
msg = EmailMessage()
# 设置邮件内容
msg.set_content('您好，这是一封来自Python的邮件', 'plain', 'utf-8')
# 发送邮件
conn.sendmail(from_addr, [to_addr], msg.as_string())
# 退出连接
conn.quit()

上面程序中，第 15 行、19 行和 23 行代码基本代表了使用 Python 的 smtp 模块发送邮件的 3 大核心步骤，其中 ① 号代码使用了发件人的地址和密码来登录邮箱。

关于该程序有以下几点需要说明：

• 程序中提供的邮箱密码是错误的，不用尝试。读者必须改为使用自己的邮箱地址和密码。
• 早期SMTP 服务器都采用普通的网络连接，因此默认端口是 25。但现在绝大部分 SMTP 都是基于 SSL（Secure Socket Layer）的，这样保证网络上传输的信息都是加密过的，从而使得信息更加安全。这种基于 SSL 的 SMTP 服务器的默认端口是 465。上面程序中连接的是 QQ 邮箱的基于 SSL 的 SMTP 服务器，QQ 邮箱服务器不支持普通的 SMTP。
• 国内有些公司的免费邮箱（比如 QQ 邮箱）默认是关闭了 SMTP 的，因此需要读者登录邮箱进行设置。
• 由于该程序发送的邮件太简单，邮件没有主题，而且程序在测试过程中可能会发送很多邮件，因此有些邮箱服务商会将该程序发送的邮件当成垃圾邮件。

早期 Python 2.x 提供了 email.mime、email.header、email.charset、email.encoders、email.iterators 等库来处理邮件，这些库设计得过于烦琐，用起来极为不便，因此读者应该尽快改为使用最新的 Python 库。本教程不会介绍这些过时的库。具体可参考 https://docs.python.org/3/library/email.html 页面的说明。

由于程序打开了 smtplib 调试模式（将 debuglevel 设置为 1），因此在运行该程序时，可以看到 SMTP 发送邮件的详细过程。当程序运行结束后，将可以在收件人邮箱中看到一封新邮件（可能在垃圾邮件内），如图 1 所示。
上面这封邮件是最简单的，没有为该邮件设置主题、发件人名字和收件人名字，邮件内容也只是简单的文本。如果要为邮件设置主题、发件人名字和收件人名字，那么只需设置 EmailMessage 对象的相应属性即可。如果程序要将邮件内容改为 HTML 内容，那么只需将调用 EmailMessage的set_content() 方法的第二个参数设置为 html 即可。

例如，如下程序只是对 EmailMessage 进行了修改：

import smtplib
from email.message import EmailMessage

# 定义SMTP服务器地址:
smtp_server = 'smtp.qq.com'
# 定义发件人地址
from_addr = 'kongyeeku@qq.com'
# 定义登录邮箱的密码
password = '123456'
# 定义收件人地址:
to_addr = 'kongyeeku@163.com'

# 创建SMTP连接
#conn = smtplib.SMTP(smtp_server, 25)
conn = smtplib.SMTP_SSL(smtp_server,465)
conn.set_debuglevel(1)
conn.login(from_addr, password)            #①
# 创建邮件对象
msg = EmailMessage()
# 设置邮件内容，指定邮件内容为HTML
msg.set_content('<h2>邮件内容</h2>' +
    '<p>您好，这是一封来自Python的邮件<p>' +
    '来自<a href="http://c.biancheng.net">C语言中文网</a>', 'html', 'utf-8')
msg['subject'] = '一封HTML邮件'
msg['from'] = '李刚 <%s>' % from_addr
msg['to'] = '新用户 <%s>' % to_addr
# 发送邮件
conn.sendmail(from_addr, [to_addr], msg.as_string())
# 退出连接
conn.quit()

该程序与上一个程序基本相似，只是在调用 set_content() 方法时将第二个参数改为了“html”。

此外，程序增加了上面 3 行代码（第 24~26 行），分别用于设置邮件主题、发件人名字和收件人名字。运行上面程序，在目标邮箱内可以看到如图 2 所示的邮件。
打开该邮件，将可以看到如图 3 所示的邮件内容。
如果希望实现图文并茂的邮件，也就是在邮件中插入图片，则首先要给邮件添加附件（不要直接在邮件中嵌入外链的图片，很多邮箱出于安全考虑，都会禁用邮件中外链的资源）。因此，如果直接在 HTML 右键中外链其他图片，那么该图片很有可能显示不出来。

为了给邮件添加附件，只需调用 EmailMessage的add_attachment() 方法即可。该方法支持很多参数，最常见的参数如下：

• maintype：指定附件的主类型。比如指定 image 代表附件是图片。
• subtype：指定附件的子类型。比如指定为 png，代表附件是 PNG 图片。一般来说，子类型受主类型的限制。
• filename：指定附件的文件名。
• cid=img：指定附件的资源 ID，邮件正文可通过资源 ID 来引用该资源。

例如，如下程序为邮件添加了 3 个附件：

import smtplib, email.utils
from email.message import EmailMessage

# 定义SMTP服务器地址:
smtp_server = 'smtp.qq.com'
# 定义发件人地址
from_addr = 'kongyeeku@qq.com'
# 定义登录邮箱的密码
password = '123456'
# 定义收件人地址:
to_addr = 'kongyeeku@163.com'

# 创建SMTP连接
#conn = smtplib.SMTP(smtp_server, 25)
conn = smtplib.SMTP_SSL(smtp_server,465)
conn.set_debuglevel(1)
conn.login(from_addr, password)            #①
# 创建邮件对象
msg = EmailMessage()
# 随机生成两个图片id
first_id, second_id = email.utils.make_msgid(), email.utils.make_msgid()
# 设置邮件内容，指定邮件内容为HTML
msg.set_content('<h2>邮件内容</h2>' +
    '<p>您好，这是一封来自Python的邮件' +
    '<img src="cid:' + second_id[1:-1] +'"><p>' +
    '来自<a href="http://c.biancheng.net">C语言中文网</a>')
msg['subject'] = '一封HTML邮件'
msg['from'] = '李刚 <%s>' % from_addr
msg['to'] = '新用户 <%s>' % to_addr
with open('E:/logo.jpg', 'rb') as f:
    # 添加第一个附件
    msg.add_attachment(f.read(), maintype='image',
        subtype='jpeg', filename='test.png', cid=first_id)
with open('E:/fklogo.gif', 'rb') as f:
    # 添加第二个附件
    msg.add_attachment(f.read(), maintype='image',
        subtype='gif', filename='test.gif', cid=second_id)
with open('E:/fkit.pdf', 'rb') as f:
    # 添加第三个附件，邮件正文不需引用该附件，因此不指定cid
    msg.add_attachment(f.read(), maintype='application',
        subtype='pdf', filename='test.pdf',)
# 发送邮件
conn.sendmail(from_addr, [to_addr], msg.as_string())
# 退出连接
conn.quit()

该程序与上一个程序的最大区别在于增加了一段代码（31 行代码起），它们为邮件添加了三个附件。

由于邮件正文不需要引用第三个附件，因此程序添加第三个附件时没有指定 cid 属性。

在添加附件时指定 cid 属性之后，程序就可以在邮件正文中通过该 cid 来引用附件，如上面程序中邮件正文代码所示。运行上面程序，可以在目标邮箱内看到一封新邮件。打开该邮件，可看到邮件内容。

通过上面三个示例，可以发现使用 smtplib 模块发送邮件很简单，基本只需要连接服务器、创建邮件和发送邮件三个步骤。如果要构建复杂的邮件内容，则主要通过 EmailMessage 对象来进行设置。EmailMessage 也是 Python 3.x 对邮件处理的巨大简化，它把对邮件内容的各种处理都封装在 EmailMessage 类中，因此使得编程变得轻松、简单。