Python通过POP3协议获取邮箱邮件完整教程

Miles

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

原创

本文详细介绍如何使用Python的poplib库连接POP3服务器并获取邮箱邮件。内容涵盖从开通POP3服务、导入必要模块、建立连接与身份认证，到获取邮件列表、解析邮件原始文本、处理日期格式以及提取邮件正文和附件的完整代码实现。

开通POP3服务与导入库

首先需要在邮箱设置中开通POP3服务，这是通过Python获取邮件的前提条件。

接着导入所需的Python库，包括用于连接服务器的poplib、处理时间的datetime、分词用的jieba、正则表达式re、邮件解析的Parser、解码头部的decode_header、解析地址的parseaddr以及用于HTML处理的lxml。


import poplib
from datetime import datetime
import jieba
import re
from email.parser import Parser
from email.header import decode_header
from email.utils import parseaddr
from lxml import etree

连接服务器与身份认证

随后进行服务器连接操作，建立与POP3服务器的会话。


name_list = []
email = 'xxx@xx.com'
password = 'xxxxxx'
pop3_server = 'imap.exmail.qq.com'
# 连接到POP3服务器:
server = poplib.POP3(pop3_server)
# 可以打开或关闭调试信息:
server.set_debuglevel(1)
# 可选:打印POP3服务器的欢迎文字:
print(server.getwelcome().decode('utf-8'))
# 身份认证:
server.user(email)
server.pass_(password)
# stat()返回邮件数量和占用空间:
print('Messages: %s. Size: %s' % server.stat())
# list()返回所有邮件的编号:
resp, mails, octets = server.list()
# 可以查看返回的列表类似[b'1 82923', b'2 2184', ...]
print(mails)
# 获取最新一封邮件, 注意索引号从1开始:
index = len(mails)
print(index,'2222')
resp, lines, octets = server.retr(284)
# lines存储了邮件的原始文本的每一行,
# 可以获得整个邮件的原始文本:
msg_content = b'\r\n'.join(lines).decode('utf-8')
# 稍后解析出邮件:
msg = Parser().parsestr(msg_content)
# print(msg)
messageObject = Parser().parsestr(msg_content)
msgDate = messageObject["date"]
print(678,msgDate)
# 可以根据邮件索引号直接从服务器删除邮件:
# server.dele(index)
# 关闭连接:

获取邮件列表与读取指定邮件

变量index表示邮件的总数量。通过调用server.retr(284)可以读取指定索引的邮件，其中284代表从最新邮件开始计数的第几个邮件索引。


try:
  GMT_FORMAT = '%a, %d %b %Y %H:%M:%S +0800 (CST)'
  new_date = datetime.strptime(msgDate, GMT_FORMAT)
except:
  GMT_FORMAT = '%a, %d %b %Y %H:%M:%S +0800'
  new_date = datetime.strptime(msgDate, GMT_FORMAT)
name_list.append(str(new_date))
print(datetime.strptime(msgDate, GMT_FORMAT))

邮件日期格式转换

直接读取到的邮件日期格式通常为“Tue, 17 Sep 2019 16:21:25 +0800(CST)”，需要将其转换为“2019-09-17 16:21:25”的标准格式以便后续处理。

继续执行后续代码逻辑。


def print_info(msg, indent=0):
  if indent == 0:
    for header in ['From', 'To', 'Subject']:
      value = msg.get(header, '')
      if value:
        if header == 'Subject':
          value = decode_str(value)
        else:
          hdr, addr = parseaddr(value)
          name = decode_str(hdr)
          value = u'%s <%s>' % (name, addr)
          print('7777',name)
      print('%s%s: %s' % (' ' * indent, header, value))
  if (msg.is_multipart()):
    parts = msg.get_payload()
    for n, part in enumerate(parts):
      print('%spart %s' % (' ' * indent, n))
      print('%s--------------------' % (' ' * indent))
      print_info(part, indent + 1)
  else:
    content_type = msg.get_content_type()
    if content_type == 'text/plain' or content_type == 'text/html':
      content = msg.get_payload(decode=True)
      charset = guess_charset(msg)
      if charset:
        content = content.decode(charset)
      print('%sText: %s' % (' ' * indent, content + '...'))
  else:
    print('%sAttachment: %s' % (' ' * indent, content_type))

解析邮件内容与辅助函数

接下来实现邮件内容的读取功能，解析邮件主体部分。

代码中还包含两个辅助函数，用于处理字符串解码和字符集猜测。


def decode_str(s):
  value, charset = decode_header(s)[0]
  if charset:
    value = value.decode(charset)
  return value
def guess_charset(msg):
  charset = msg.get_charset()
  if charset is None:
    content_type = msg.get('Content-Type', '').lower()
    pos = content_type.find('charset=')
    if pos >= 0:
      charset = content_type[pos + 8:].strip()
  return charset
print_info(msg = msg)
print(name_list)
server.quit()

至此，邮件获取的核心功能实现完毕。