Python使用imap-tools模块下载邮件附件的示例

Alice
Alice
发布时间:2026-10-15 | 5人浏览过
原创

本文介绍使用Python第三方库imap-tools简化邮件附件下载的方法。通过封装imaplib,该模块能显著减少代码量。文中提供了基于Python 3.8环境的完整示例,展示如何登录IMAP服务器、遍历邮件并保存附件文件,同时附带原生imaplib与BeautifulSoup解析邮件内容的对比代码。

imap-tools模块简介与安装

近期在进行与电子邮件相关的办公自动化项目时,发现了一个名为imap-tools的第三方模块。由于网络上关于该模块的详细介绍较少,特此记录其使用方法。

运行环境为Python 3.8,使用的imap-tools版本为0.39.0。

首先需要通过pip命令安装imap-tools模块。

imap-tools是Python的一个第三方扩展库,它基于标准库imaplib构建,将常见的邮件处理操作进行了封装,使得处理邮件的代码更加简洁。以下是一个下载邮件附件的示例代码。

使用imap-tools下载附件示例


from imap_tools import MailBox

with MailBox("imap服务器名").login("账号", "密码") as mailbox:
    for msg in mailbox.fetch(limit=2,reverse=True):  # 我这里为了避免读取全部的邮件,加上了limit=2的匹配参数,读取两封邮件,按照最新接收的次序排序,进行测试; 
        for att in msg.attachments:  # msg为上一行取得的全部邮件
            if att.filename:    # 如果附件的文件名不为空
                att_data = att.payload # 获得附件的内容
                f = open(att.filename,'wb') # 用二进制打开,一般邮件附件都是二进制的.
                f.write(att_data)
                f.close()

代码非常简短,使用体验比直接使用imaplib更加顺畅。

原生imaplib与BeautifulSoup读取邮件示例

补充说明:关于使用Python的imap和email模块读取邮件的方法。

网络上关于SMTP发送邮件的文章较多,但完整介绍如何读取邮件的内容较少。本文主要讲解Python 3环境下读取邮件的编码处理,并结合BeautifulSoup解析邮件正文内容。

使用的Python版本信息如下所示。

Python 3.8.2 (tags/v3.8.2:7b3ab59, Feb 25 2020, 23:03:10) [MSC v.1916 64 bit (AMD64)] on win32

以下是使用原生imaplib和email模块读取邮件的完整代码示例。

原生模块读取邮件完整代码


import email
import imaplib
from bs4 import BeautifulSoup
def main():
    try:
		# 填写需要读取邮件服务器的imap的host和port,不知道请联系管理员
        conn = imaplib.IMAP4_SSL(host='imap.xxx.com', port='993')
		# 读取邮件的用户名和密码
        conn.login('xxx@qq.com', 'your password')
        # 默认选择收件箱 INBOX
        conn.select()
		# Recent\Seen参数不起作用,暂先读取所有邮件
        status, data = conn.search(None, 'ALL')  
        if status != 'OK':
            raise Exception('读取邮件发生错误')
        emailids = data[0].split()
        # 倒序读取邮件
        mail_counts = len(emailids)
        for i in range(mail_counts-1, 0, -1):
			# 获取邮件信息
            status, edata = conn.fetch(emailids[i], '(RFC822)')
            # Message对象
            msg = email.message_from_bytes(edata[0][1])
            # 标题
            subject = email.header.decode_header(msg.get('subject'))
            # subject包含文档编码
            default_code = subject[0][1]
            # print('Content_Type', msg.get_content_type())
            ctype = msg.get_content_type()
			# 是否multipart类型,分别处理
            if msg.is_multipart():
                pl = msg.get_payload()
                for m in pl:
                    ctype = m.get_content_type()
                    if 'html' in ctype:
						# 注意decode参数,如果是True将解码base64/quoted-printable等格式编码内容,否则不解码
                        html = str(m.get_payload(decode=True), m.get('content-type').split('=')[1])
                    # BeautifulSoup解析网页
                    soup = BeautifulSoup(html, "lxml")
                    divs = soup.select('body')
                    for d in divs:
						# 提取所有文本内容
                        text = d.get_text(strip=True)  
                        print(text)
            else:
                html = str(msg.get_payload(decode=True), default_code)
                # BeautifulSoup解析网页
                soup = BeautifulSoup(html, "lxml")
				# 提取body标签里面的所有文本内容
                divs = soup.select('body')  
                for d in divs:
                    text = d.get_text(strip=True)
                    print(text)
    except Exception as ex:
        print(ex)
    finally:
        # close
        conn.close()
        conn.logout()
if __name__ == "__main__":
    main()

至此,关于使用Python imap-tools模块下载邮件附件的介绍完毕。如需了解更多Python下载邮件附件的相关内容,建议查阅本站过往文章或继续浏览后续文章,感谢支持。

本站声明

本文内容仅供参考,不代表本站观点。转载或引用请注明出处。如发现内容问题,请通过联系我们页面反馈。

Python 相关产品和应用

全部下载

专题列表