一、背景介绍：邮件管理的自动化需求
在现代办公环境中，邮件已成为信息传递的重要方式。然而，随着邮件数量的增加，手动管理变得低效且容易出错。尤其在处理合同、方案、报价等关键业务邮件时，若因误操作导致邮件丢失或归档混乱，可能对工作造成严重影响。
为了解决这一问题，我们开发了一个基于Python的智能邮件自动备份与关键词分类器。该工具通过IMAP协议连接邮箱服务器，自动下载包含指定关键词的邮件及其附件，并按日期和关键词分类保存到本地文件夹中，实现邮件内容的自动化备份与管理。
本项目不仅适用于企业用户，也适合个人用户进行邮件归档和信息管理。通过该项目的学习，开发者可以掌握邮件处理、文件管理、关键词匹配等核心技术，为构建更复杂的邮件自动化工具打下基础。
二、思路分析：如何构建一个邮件自动备份与分类器
本项目的核心流程可以分为以下几个步骤：
- 连接邮箱服务器：使用
imaplib连接到IMAP服务器（如QQ邮箱、163邮箱）； - 登录与搜索邮件：通过授权码登录邮箱，并使用关键词筛选邮件；
- 解析邮件内容：使用
email模块解析邮件结构，提取主题、正文和附件； - 处理中文乱码：使用
email.header.decode_header对邮件标题和正文进行中文解码； - 保存邮件与附件：将邮件正文和附件分别保存到本地文件夹，按日期和关键词分类；
- 记录操作日志：使用
logging模块记录关键操作，便于调试与追踪。
整个流程无需依赖第三方框架，仅使用Python标准库即可实现，适合本地独立运行。
三、代码实现（Python）
# 智能邮件自动备份与关键词分类器
import imaplib
import email
from email.header import decode_header
import os
from datetime import datetime
import logging
# 设置日志记录
logging.basicConfig(level=logging.INFO, format='%(asctime)s, %(levelname)s - %(message)s')
# 配置信息（请根据实际情况修改）
EMAIL = "your_email@qq.com" # 示例：QQ邮箱
PASSWORD = "your_authorization_code" # 邮箱授权码
SAVE_PATH = "D:/EmailBackup" # 邮件保存路径
KEYWORDS = ["合同", "方案", "报价"] # 可自定义关键词列表
# 创建保存目录
if not os.path.exists(SAVE_PATH):
os.makedirs(SAVE_PATH)
logging.info(f"创建备份目录：{SAVE_PATH}")
# 解码中文字符串
def decode_str(s):
decoded = decode_header(s)
result = ""
for part, charset in decoded:
if charset:
result += part.decode(charset)
else:
result += str(part)
return result
# 保存邮件正文
def save_email_content(subject, from_addr, date_str, body, save_path):
# 将日期字符串解析为datetime对象
date_obj = datetime.strptime(date_str[:24], "%a, %d %b %Y %H:%M:%S")
# 构建日期文件夹
date_folder = date_obj.strftime("%Y-%m-%d")
daily_save_path = os.path.join(save_path, date_folder)
if not os.path.exists(daily_save_path):
os.makedirs(daily_save_path)
logging.info(f"创建日期文件夹：{daily_save_path}")
# 构建邮件正文内容
email_content = f"标题：{subject}\n发件人：{from_addr}\n日期：{date_str}\n\n正文：\n{body}"
# 构建文件名
filename = f"{date_obj.strftime('%H%M%S')}_{subject[:20]}.txt"
file_path = os.path.join(daily_save_path, filename)
with open(file_path, "w", encoding="utf-8") as f:
f.write(email_content)
logging.info(f"邮件正文已保存至：{file_path}")
# 保存邮件附件
def save_attachment(part, save_path):
filename = part.get_filename()
if not filename:
return
# 解码附件文件名
filename = decode_str(filename)
# 获取当前日期，用于创建文件夹
date_obj = datetime.now()
date_folder = date_obj.strftime("%Y-%m-%d")
daily_save_path = os.path.join(save_path, date_folder)
if not os.path.exists(daily_save_path):
os.makedirs(daily_save_path)
logging.info(f"创建日期文件夹：{daily_save_path}")
# 避免文件名重复
base, ext = os.path.splitext(filename)
counter = 1
while os.path.exists(os.path.join(daily_save_path, filename)):
filename = f"{base}_{counter}{ext}"
counter += 1
file_path = os.path.join(daily_save_path, filename)
with open(file_path, "wb") as f:
f.write(part.get_payload(decode=True))
logging.info(f"附件保存路径：{file_path}")
# 邮件备份主函数
def backup_emails():
try:
# 根据邮箱类型选择IMAP服务器
if "qq.com" in EMAIL:
server = imaplib.IMAP4_SSL("imap.qq.com")
elif "163.com" in EMAIL:
server = imaplib.IMAP4_SSL("imap.163.com")
else:
logging.error("暂不支持该邮箱类型，请使用QQ或163邮箱")
return
# 登录邮箱
server.login(EMAIL, PASSWORD)
logging.info(f"登录邮箱成功：{EMAIL}")
# 选择收件箱
server.select("inbox")
# 构建关键词搜索语句
keyword_str = " OR ".join([f'(SUBJECT "{kw}" OR BODY "{kw}")' for kw in KEYWORDS])
status, email_ids = server.search(None, f"({keyword_str})", "UNDELETED")
if status != "OK":
logging.error(f"搜索邮件失败：{status}")
return
email_id_list = email_ids[0].split()
if not email_id_list:
logging.info("未找到包含指定关键词的邮件")
return
logging.info(f"共找到 {len(email_id_list)} 封需要备份的邮件")
for email_id in email_id_list:
# 获取邮件内容
status, msg_data = server.fetch(email_id, "(RFC822)")
if status != "OK":
logging.warning(f"获取邮件 {email_id} 失败")
continue
msg = email.message_from_bytes(msg_data[0][1])
subject = decode_str(msg["Subject"])
from_addr = decode_str(msg["From"])
date_str = decode_str(msg["Date"])
body = ""
# 提取正文内容
if msg.is_multipart():
for part in msg.walk():
content_type = part.get_content_type()
if content_type == "text/plain" and part.get_content_disposition() is None:
body = part.get_payload(decode=True).decode("utf-8", errors="ignore")
break
else:
body = msg.get_payload(decode=True).decode("utf-8", errors="ignore")
# 保存邮件正文
save_email_content(subject, from_addr, date_str, body, SAVE_PATH)
# 保存附件
for part in msg.walk():
if part.get_content_disposition() == "attachment":
save_attachment(part, SAVE_PATH)
server.logout()
logging.info("邮箱连接已关闭。")
except Exception as e:
logging.error(f"发生异常：{e}")
# 运行主函数
if __name__ == "__main__":
backup_emails()
四、项目结构与运行说明
目录结构示例：
email_backup_tool/
│
├── main.py
└── logs/
└── email_backup.log # 可选日志文件
运行环境要求：
- 操作系统：Windows、Linux、macOS；
- Python 版本：3.7 及以上；
- 依赖库：无需额外安装，使用 Python 标准库（
imaplib,email,os,datetime,logging）； - 邮箱支持：QQ邮箱、163邮箱等支持IMAP服务的邮箱。
使用步骤：
- 修改
main.py中的EMAIL、PASSWORD、SAVE_PATH和KEYWORDS； - 确保邮箱IMAP服务已开启，并获取授权码；
- 运行
main.py； - 查看
SAVE_PATH目录下的邮件备份文件； - （可选）将脚本设置为定时任务，实现自动备份。
五、学习价值与扩展建议
学习价值：
- 掌握IMAP协议的基本使用，实现与邮箱服务器的交互；
- 学习邮件解析与附件提取技术，理解MIME结构；
- 实践中文解码与文件路径管理，提升数据处理能力；
- 了解日志记录与异常处理机制，提高代码健壮性；
- 熟悉关键词匹配与自动化备份流程，增强系统工具开发能力。
扩展建议：
- 支持更多邮箱类型：如Gmail、Outlook等；
- 邮件自动归档：将邮件移动到特定文件夹，避免重复处理；
- 图形界面（GUI）：使用
tkinter构建配置界面； - 邮件正文关键词提取：结合NLP技术提取关键信息；
- 邮件内容加密存储：使用
cryptography模块对备份内容进行加密； - 集成定时任务：使用
schedule或APScheduler实现每日自动备份。
六、总结
本项目实现了一个基于Python的智能邮件自动备份与关键词分类器，通过IMAP协议连接邮箱，自动下载包含指定关键词的邮件及其附件，并分类保存到本地目录。该工具功能明确、结构清晰，适合中级以下开发者在1~3天内完成，并具备良好的学习价值与扩展性。
通过本项目的学习，开发者可以掌握邮件自动化处理的基本流程，提升本地系统工具的开发能力，为构建更复杂的邮件管理工具（如AI分类、自动回复）打下坚实基础。
本文由AI大模型（电信天翼量子AI云电脑-云智助手-Qwen3-32B）结合行业知识与创新视角深度思考后创作。