Python如何使用email、smtplib、poplib、imaplib模块收发邮件

时间：2023-05-17 11:50

一封电子邮件的旅程是：

Mail User Agent (MUA) refers to an email client or software used by a user to access their email account.。(即类似Outlook的电子邮件软件）
MTA：Mail Transfer Agent——邮件传输代理，就是那些Email服务提供商，比如网易、新浪等等。
MDA：Mail Delivery Agent——邮件投递代理。Email服务提供商的某个服务器

发件人 -> MUA -> MTA -> MTA -> 若干个MTA -> MDA <- MUA <- 收件人

要编写程序来发送和接收邮件，本质上就是：

编写MUA把邮件发到MTA；
编写MUA从MDA上收邮件。

发邮件时，MUA和MTA使用的协议就是SMTP：Simple Mail Transfer Protocol，后面的MTA到另一个MTA也是用SMTP协议。

收邮件时，MUA和MDA使用的协议有两种：POP：Post Office Protocol，目前版本是3，俗称POP3；IMAP：Internet Message Access Protocol，目前版本是4，优点是不但能取邮件，还可以直接操作MDA上存储的邮件，比如从收件箱移到垃圾箱，等等。

一、SMTP（Simple Mail Transfer Protocol）

即简单邮件传输协议,它是一组用于由源地址到目的地址传送邮件的规则，由它来控制信件的中转方式。

python的smtplib提供了一种很方便的途径发送电子邮件。它对smtp协议进行了简单的封装。

Python对SMTP支持有smtplib和email两个模块，email负责构造邮件，smtplib负责发送邮件。

1、构造邮件：email.mime类型

构造一个邮件对象就是一个Messag对象，如果构造一个MIMEText对象，就表示一个文本邮件对象，如果构造一个MIMEImage对象，就表示一个作为附件的图片，要把多个对象组合起来，就用MIMEMultipart对象，而MIMEBase可以表示任何对象。它们的继承关系如下：

Message+- MIMEBase   +- MIMEMultipart   +- MIMENonMultipart      +- MIMEMessage      +- MIMEText      +- MIMEImage

首先，我们来构造一个最简单的纯文本邮件，然后，通过SMTP发出去。

from email.mime.text import MIMETextmsg = MIMEText('hello, send by Python...', 'plain', 'utf-8')

注意到构造MIMEText对象时，第一个参数就是邮件正文，第二个参数是MIME的subtype，传入'plain'，最终的MIME就是'text/plain'，最后一定要用utf-8编码保证多语言兼容性。

2、创建 SMTP 对象

语法如下：

import smtplibsmtpObj = smtplib.SMTP( [host [, port [, local_hostname]]] )

参数说明：

host: SMTP 服务器主机。这个参数可选，你可以根据需要指定主机的IP地址或者域名，例如：runoob.com。
port: 如果你提供了 host 参数, 你需要指定 SMTP 服务使用的端口号，一般情况下 SMTP 端口号为25。
local_hostname: 如果 SMTP 在你的本机上，你只需要指定服务器地址为 localhost 即可。

3、Python SMTP 对象使用 sendmail 方法发送邮件

语法如下：

SMTP.sendmail(from_addr, to_addrs, msg[, mail_options, rcpt_options])

参数说明：

from_addr: 邮件发送者地址。
to_addrs: 字符串列表，邮件发送地址。
msg: 发送消息

这里要注意一下第三个参数，msg 是字符串，表示邮件。要发送邮件，就必须注意信息的格式，因为邮件通常包括标题、发件人、收件人、邮件内容和附件等。这个格式就是 smtp 协议中定义的格式。

二、实例

2：本机已安装支持 SMTP 的服务

以下执行实例需要你本机已安装了支持 SMTP 的服务。

sendmail()方法就是发邮件，由于可以一次发给多个人，所以传入一个list，邮件正文是一个str，as_string()把MIMEText对象变成str。

经过Header对象编码的文本，包含utf-8编码信息和Base64编码的文本。

以下是一个使用 Python 发送邮件简单的实例：

import smtplibfrom email.mime.text import MIMETextfrom email.header import Header sender = 'from@runoob.com'receivers = ['429240967@qq.com']  # 接收邮件，可设置为你的QQ邮箱或者其他邮箱 # 三个参数：第一个为文本内容，第二个 plain 设置文本格式，第三个 utf-8 设置编码message = MIMEText('Python 邮件发送测试内容...', 'plain', 'utf-8')message['From'] = Header("菜鸟教程", 'utf-8')   # 发送者message['To'] =  Header("测试", 'utf-8')        # 接收者message['Subject'] = Header('Python SMTP 邮件测试主题', 'utf-8') try:    smtpObj = smtplib.SMTP('localhost')    smtpObj.sendmail(sender, receivers, message.as_string())    print "邮件发送成功"except smtplib.SMTPException:    print "Error: 无法发送邮件"

2、使用第三方 SMTP 服务

如果我们本机没有 sendmail 访问，也可以使用其他邮件服务商的 SMTP 访问（QQ、网易、Google等）。

login()方法用来登录SMTP服务器

发收件件人的名字没有显示为友好的名字，比如Mr Green ；

使用 formataddr方法来格式化一个邮件地址。如果包含中文，需要通过Header对象进行编码。

msg['To']接收的是字符串而不是list，如果有多个邮件地址，用,分隔即可。

import smtplibfrom email.mime.text import MIMETextfrom email.utils import formataddr# 第三方 SMTP 服务mail_host = "mail.sss.com"  # 设置服务器mail_user = "it_system@sss.com"  # 用户名mail_pass = "Ssss201709#"  # 口令sender = 'it_system@tcl.com'receivers = 'sss.yang@tcsssl.com'  # 接收邮件，可设置为你的QQ邮箱或者其他邮箱message = MIMEText('Python 邮件内容测试...', 'plain', 'utf-8')message['From'] = formataddr(('SCBC-啊iT',   sender))message['To'] = formataddr(('杨生', receivers))message['Subject'] = 'Python SMTP 邮件测试'try:    smtpObj = smtplib.SMTP()    smtpObj.connect(mail_host, 25)  # 25 为 SMTP 端口号    smtpObj.login(mail_user, mail_pass)    smtpObj.sendmail(sender, receivers, message.as_string())    print("邮件发送成功")except smtplib.SMTPException:    print("Error: 无法发送邮件")

3、使用Python发送HTML格式的邮件

Python在构造MIMEText对象时，把HTML字符串传进去，再把第二个参数由plain变为html就可以了：

具体代码如下：

mail_msg = """Python 邮件内容测试...这是一个链接"""message = MIMEText(mail_msg, 'html', 'utf-8')

4、Python 发送带附件的邮件

带附件的邮件可以看做包含若干部分的邮件：文本和各个附件本身，所以，可以构造一个MIMEMultipart对象代表邮件本身，然后往里面加上一个MIMEText作为邮件正文，再继续往里面加上表示附件的MIMEBase对象即可。

发送带附件的邮件，首先要创建MIMEMultipart()实例，然后构造附件，如果有多个附件，可依次构造，最后利用smtplib.smtp发送。

from email.mime.multipart import MIMEMultipart# 创建一个带附件的实例message = MIMEMultipart()message['From'] = formataddr(('SCBC-啊iT', sender))message['To'] = formataddr(('杨生', receivers))message['Subject'] = 'Python SMTP 邮件测试'mail_msg = """Python 邮件内容测试...这是一个链接"""# 邮件正文内容message.attach(MIMEText(mail_msg, 'html', 'utf-8'))# 构造附件1，传送当前目录下的 test.txt 文件att = MIMEText(open('32.txt', 'rb').read(), 'base64', 'utf-8')att["Content-Type"] = 'application/octet-stream'# 这里的filename可以任意写，写什么名字，邮件中显示什么名字att["Content-Disposition"] = 'attachment; filename="32.txt"'message.attach(att)

5、在 HTML 文本中添加图片

要把图片嵌入到邮件正文中，我们只需按照发送附件的方式，先把邮件作为附件添加进去，然后，在HTML中通过引用src="cid:0"就可以把附件作为图片嵌入了。如果有多个图片，给它们依次编号，然后引用不同的cid:x即可。

邮件的 HTML 文本中一般邮件服务商添加外链是无效的，正确添加图片的实例如下所示：

from email.mime.multipart import MIMEMultipartfrom email.mime.image import MIMEImage# 创建一个带附件的实例message = MIMEMultipart()message['From'] = formataddr(('SCBC-啊iT', sender))message['To'] = formataddr(('杨生', receivers))message['Subject'] = 'Python SMTP 邮件测试'mail_msg = """Python 邮件内容测试...这是一个链接图片演示："""# 邮件正文内容message.attach(MIMEText(mail_msg, 'html', 'utf-8'))# 指定图片为当前目录with  open('a.jpg', 'rb') as fp:    msgImage = MIMEImage(fp.read())# 定义图片 ID，在 HTML 文本中引用msgImage.add_header('Content-ID', '')message.attach(msgImage)

或者通过MIMEBase来添加图片

# 指定图片为当前目录with  open('a.jpg', 'rb') as fp:    # 设置附件的MIME和文件名，这里是png类型:    mime = MIMEBase('image', 'jpg', filename='a.jpg')    # 加上必要的头信息:    mime.add_header('Content-Disposition', 'attachment', filename='附件显示名称.jpg')    mime.add_header('Content-ID', '')  # 如果有多个文件需要使用.format(index)    mime.add_header('X-Attachment-Id', '0')  # 如果有多个文件需要使用.format(index)    # 把附件的内容读进来:    mime.set_payload(fp.read())    # 用Base64编码:    encoders.encode_base64(mime)    # 添加到MIMEMultipart:    message.attach(mime)

6、同时支持HTML和Plain格式

如果我们发送HTML邮件，收件人通过浏览器或者Outlook之类的软件是可以正常浏览邮件内容的，但是，如果收件人使用的设备太古老，查看不了HTML邮件怎么办？

办法是在发送HTML的同时再附加一个纯文本，如果收件人无法查看HTML格式的邮件，就可以自动降级查看纯文本邮件。

利用MIMEMultipart就可以组合一个HTML和Plain，要注意指定subtype是alternative：

msg = MIMEMultipart('alternative')msg['From'] = ...msg['To'] = ...msg['Subject'] = ...msg.attach(MIMEText('hello', 'plain', 'utf-8'))msg.attach(MIMEText('Hello', 'html', 'utf-8'))# 正常发送msg对象...

7、加密SMTP

如果使用标准的25端口连接SMTP服务器发送邮件，即使身份验证成功，因为明文传输的缘故，整个邮件发送过程都有可能被窃听。要更安全地发送邮件，可以加密SMTP会话，实际上就是先创建SSL安全连接，然后再使用SMTP协议发送邮件。

在某些邮件服务提供商（例如Gmail）中，SMTP服务必须使用加密传输。我们来看看如何通过Gmail提供的安全SMTP发送邮件。

只需要在创建SMTP对象后，立刻调用starttls()方法，就创建了安全连接。后面的代码和前面的发送邮件代码完全一样。

必须知道，Gmail的SMTP端口是587，因此，修改代码如下：

smtp_server = 'smtp.gmail.com'smtp_port = 587server = smtplib.SMTP(smtp_server, smtp_port)server.starttls()# 剩下的代码和前面的一模一样:server.set_debuglevel(1)

三、使用poplib接收邮件

收取邮件就是编写一个MUA作为客户端，从MDA把邮件获取到用户的电脑或者手机上。收取邮件最常用的协议是POP协议，目前版本号是3，俗称POP3。

Python内置一个poplib模块，实现了POP3协议，可以直接用来收邮件。

POP3 的命令和响应数据都是基于 ASCII 文本的，并以 CR 和 LF(/r/n) 作为行结束符，响应数据包括一个表示返回状态的符号（+/）和描述信息。

请求和响应的标准格式如下：

请求标准格式：命令 [参数] CRLF
响应标准格式：+OK /[-ERR] description CRLF

POP3 协议客户端的命令和服务器端对应的响应数据如下：

user name：向 POP 服务器发送登录的用户名。
pass string：向 POP 服务器发送登录的密码。
quit：退出 POP 服务器。
stat：统计邮件服务器状态，包括邮件数和总大小。
list [msg_no]：列出全部邮件或指定邮件。返回邮件编号和对应大小。
retr msg_no：获取指定邮件的内容（根据邮件编号来获取，编号从 1 开始）。
dele msg_no：删除指定邮件（根据邮件编号来删除，编号从 1 开始）。
noop：空操作。仅用于与服务器保持连接。
rset：用于撤销 dele 命令。

poplib 模块完全模拟了上面命令，poplib.POP3 或 poplib.POP3_SSL 为上面命令提供了相应的方法，开发者只要依次使用上面命令即可从服务器端下载对应的邮件

注意到POP3协议收取的不是一个已经可以阅读的邮件本身，而是邮件的原始文本，这和SMTP协议很像，SMTP发送的也是经过编码后的一大段文本。

要把POP3收取的文本变成可以阅读的邮件，还需要用email模块提供的各种类来解析原始文本，变成可阅读的邮件对象。

所以，收取邮件分两步：

第一步：使用poplib.POP3 或 poplib.POP3_SSL 按 POP3 协议把邮件的原始文本下载到本地；

用POP3获取邮件其实很简单，要获取所有邮件，只需要循环使用retr()把每一封邮件内容拿到即可。真正麻烦的是把邮件的原始内容解析为可以阅读的邮件对象。

import poplibfrom email.parser import Parser# email.parser 解析电子邮件,返回这个对象的email.message.Message实例from email.header import decode_headerfrom email.utils import parseaddr# 服务器及用户信息host = 'mail.tcl.com'username = 'bobin.yang@tcl.com'password = 'Ybb7654321'# 连接到POP3服务器conn = poplib.POP3_SSL(host)# 注意qq邮箱使用SSL连接# 设置调试模式，可以看到与服务器的交互信息conn.set_debuglevel(1)# 打印POP3服务器的欢迎文字print(conn.getwelcome().decode("utf-8"))# 身份认证conn.user(username)conn.pass_(password)# 获取服务器上信件信息,返回一个列表,第一项是一共有多少封邮件,第二项是共有多少字节# stat()返回邮件数量和占用空间mail_total, total_size = conn.stat()print('message: %s.Size:%s' % (mail_total, total_size))# list()返回(response, ['mesg_num octets', ...], octets)，第二项是编号resp, mails, octets = conn.list()print(mails)# 返回的列表类似[b'1 82923', b'2 2184', ...]# 获取最新一封邮件，注意索引号从1开始# POP3.retr(which) 检索序号which的这个邮件，然后设置他的出现标志 返回(response, ['line', ...], octets)这个三元组resp, lines, ocetes = conn.retr(len(mails))print('lines:', len(lines))# lines 存储了邮件的原始文本的每一行# 可以获得整个邮件的原始文本print("-------------------")

第二步：使用 email.parser.Parser或BytesParser 解析邮件内容为`消息`对象，然后，用适当的形式把邮件内容展示给用户即可。

解析邮件的过程和上一节构造邮件正好相反。

程序在创建 BytesParser（解析字节串格式的邮件数据）或 Parser（解析字符串格式的邮件数据）时，必须指定 policy=default；否则，BytesParse 或 Parser 解析邮件数据得到的就是过时的 Message 对象，，不是新的 EmailMessage，处理起来非常不方便。

1、使用 email.parser.Parser解析邮件内容为 email.message.Message（过时，不推荐）

msg = b'
'.join(lines).decode('utf-8')# 解析出邮件msg = Parser().parsestr(msg)# email.Parser.parsestr(text, headersonly=False)# 与parser()方法类似，不同的是他接受一个字符串对象而不是一个类似文件的对象# 可选的headersonly表示是否在解析玩标题后停止解析，默认为否# 返回根消息对象# 编码处理，文本邮件的内容也是str，还需要检测编码，否则，非UTF-8编码的邮件都无法正常显示def guess_charset(msg):    charset = msg.get_charset()  # 从msg对象获取编码    if charset is None:        content_type = msg.get('Content-Type', '').lower()  # 如果获取不到，再从content—type字段获取        if 'charset' in content_type:            charset = content_type.split('charset=')[1].strip()            return charset    return charset# 数据解码，邮件的Subject或者Email中包含的名字都是经过编码后的str，要正常显示，就必须decodedef decode_str(s):    value, charset = decode_header(s)[0]  # 数据,数据编码方式，from email.header import decode_header    # decode_header()返回一个list，因为像Cc、Bcc这样的字段可能包含多个邮件地址，所以解析出来的会有多个元素。上面的代码我们偷了个懒，只取了第一个元素。    if charset:        value = value.decode(charset)    return value# print_ingo函数：解析邮件与构造邮件的步骤正好相反def print_info(msg, indent=0):  # indent用于缩进显示    if indent == 0:        for header in ['From', 'To', 'Subject']:  # 邮件的from、to、subject存在于根对象上            value = msg.get(header, '')            if value:                if header == 'Subject':                    value = decode_str(value)  # 需要解码subject字符串                else:                    # 解码mail地址                    hdr, addr = parseaddr(value)                    name = decode_str(hdr)                    value = '%s' % addr            print('%s:  %s  %s' % (header, value, name))            print('-*-' * 20)    if msg.is_multipart():        # 如果邮件对象是一个is_multipart,get_payload()返回一个list，包含所有子对象        parts = msg.get_payload()  # 循环获得列表项        for n, part in enumerate(parts):            # print('%spart %s' % ('  ' * indent, n))            # print('%s------------' % ('  ' * indent))            # 递归打印没一个子对象            print_info(part, indent + 1)    else:        # 邮件对象不是一个is_multipart,就根据content_type判断        content_type = msg.get_content_type()  # 数据类型        if content_type == 'text/plain' or content_type == 'text/html':  # 纯文本 html文本            # 纯文本或html内容            content = msg.get_payload(decode=True)  # 获得文本对象的字符串而非对象本身            charset = guess_charset(msg)  # 要检测文本编码            if charset: content = content.decode(charset)            content = '%s' % (content)            print(content)  # 获取邮件文本内容，如果只有文本，打印显示的结果和邮件中看的效果一模一样        else:            print(content_type+'不是文本')print_info(msg, 0)# 退出conn.quit()

2、使用email.parser.BytesParser 解析成email.message.EmailMessage对象

如果程序要获取邮件的发件人、收件人和主题，直接通过 EmailMessage 的相应属性来获取即可，与前面为 EmailMessage 设置发件人、收件人和主题的方式是对应的。
如果程序要读取 EmailMessage 的各部分，则需要调用该对象的 walk() 方法，该方法返回一个可迭代对象，程序使用 for 循环遍历 walk() 方法的返回值，对邮件内容进行逐项处理：

如果邮件某项的 maintype 是 'multipart'，则说明这一项是容器，用于包含邮件内容、附件等其他项。
如果邮件某项的 maintype 是 'text'，则说明这一项的内容是文本，通常就是邮件正文或文本附件。对于这种文本内容，程序直接将其输出到控制台中。
如果邮件中某个项的 maintype 属性是“其他”，那么这一项的内容就是作为附件的，程序会将附件内容保存到本地文件中。

import osimport poplibimport mimetypesfrom email.parser import Parser, BytesParserfrom email.policy import defaultmsg_data = b'
'.join(lines)# 将字符串内容解析成邮件，此处一定要指定policy=defaultmsg = BytesParser(policy=default).parsebytes(msg_data)print(type(msg))print('发件人:' + msg['from'])print('收件人:' + msg['to'])print('主题:' + msg['subject'])print('第一个收件人名字:' + msg['to'].addresses[0].username)print('第一个发件人名字:' + msg['from'].addresses[0].username)for part in msg.walk():    counter = 1    # 如果maintype是multipart，说明是容器（用于包含正文、附件等）    if part.get_content_maintype() == 'multipart':        continue    # 如果maintype是multipart，说明是邮件正文部分    elif part.get_content_maintype() == 'text':        print(part.get_content())    # 处理附件    else:        # 获取附件的文件名        filename = part.get_filename()        # 如果没有文件名，程序要负责为附件生成文件名        if not filename:            # 根据附件的contnet_type来推测它的后缀名            ext = mimetypes.guess_extension(part.get_content_type())            # 如果推测不出后缀名            if not ext:                # 使用.bin作为后缀名                ext = '.bin'            # 程序为附件来生成文件名            filename = 'part-%03d%s' % (counter, ext)        counter += 1        # 将附件写入的本地文件        with open(os.path.join('.', filename), 'wb') as fp:            fp.write(part.get_payload(decode=True))# 退出服务器，相当于发送POP 3的quit命令conn.quit()

四、利用imaplib读取邮件文本内容及附件内容

通过IMAP协议来管理邮箱用的,称作交互邮件访问协议。

! encoding:utf8'''环境：    Win10 64位 Python 2.7.5参考：    http://www.pythonclub.org/python-network-application/email-format    http://blog.sina.com.cn/s/blog_4deeda2501016eyf.html'''import imaplibimport emaildef parseHeader(message):    """ 解析邮件首部 """    subject = message.get('subject')      h = email.Header.Header(subject)    dh = email.Header.decode_header(h)    subject = unicode(dh[0][0], dh[0][1]).encode('gb2312')    # 主题    print subject    print ''    # 发件人    print 'From:', email.utils.parseaddr(message.get('from'))[1]    print ''    # 收件人    print 'To:', email.utils.parseaddr(message.get('to'))[1]    print ''    # 抄送人    print 'Cc:',email.utils.parseaddr(message.get_all('cc'))[1]def parseBody(message):    """ 解析邮件/信体 """    # 循环信件中的每一个mime的数据块    for part in message.walk():        # 这里要判断是否是multipart，是的话，里面的数据是一个message 列表        if not part.is_multipart():            charset = part.get_charset()            # print 'charset: ', charset            contenttype = part.get_content_type()            # print 'content-type', contenttype            name = part.get_param("name") #如果是附件，这里就会取出附件的文件名            if name:                # 有附件                # 下面的三行代码只是为了解码象=?gbk?Q?=CF=E0=C6=AC.rar?=这样的文件名                fh = email.Header.Header(name)                fdh = email.Header.decode_header(fh)                fname = dh[0][0]                print '附件名:', fname                # attach_data = par.get_payload(decode=True) #　解码出附件数据，然后存储到文件中                # try:                #     f = open(fname, 'wb') #注意一定要用wb来打开文件，因为附件一般都是二进制文件                # except:                #     print '附件名有非法字符，自动换一个'                #     f = open('aaaa', 'wb')                # f.write(attach_data)                # f.close()            else:                #不是附件，是文本内容                print part.get_payload(decode=True) # 解码出文本内容，直接输出来就可以了。                # pass            # print '+'*60 # 用来区别各个部分的输出def getMail(host, username, password, port=993):    try:        serv = imaplib.IMAP4_SSL(host, port)    except Exception, e:        serv = imaplib.IMAP4(host, port)    serv.login(username, password)    serv.select()    # 搜索邮件内容    typ, data = serv.search(None, '(FROM "xx@xxx.com")')    count = 1    pcount = 1    for num in data[0].split()[::-1]:        typ, data = serv.fetch(num, '(RFC822)')        text = data[0][1]        message = email.message_from_string(text)   # 转换为email.message对象        parseHeader(message)        print ''        parseBody(message)           pcount += 1        if pcount > count:            break    serv.close()    serv.logout()if __name__ == '__main__':    host = "imap.mail_serv.com" # "pop.mail_serv.com"    username = "Trevor@mail_serv.com"    password = "your_password"    getMail(host, username, password)

以上就是Python如何使用email、smtplib、poplib、imaplib模块收发邮件的详细内容，更多请关注Gxl网其它相关文章！