一、背景介绍：邮件管理的自动化需求
在现代办公环境中，邮件已成为信息传递的重要方式。然而，随着邮件数量的增加，手动管理变得低效且容易出错。尤其在处理合同、方案、报价等关键业务邮件时，若因误操作导致邮件丢失或归档混乱，可能对工作造成严重影响。
为了解决这一问题，我们开发了一个基于Python的智能邮件自动备份与关键词分类器。该工具通过IMAP协议连接邮箱服务器，自动下载包含指定关键词的邮件及其附件，并按日期和关键词分类保存到本地文件夹中，实现邮件内容的自动化备份与管理。
本项目不仅适用于企业用户，也适合个人用户，帮助其高效管理邮件，避免信息丢失。通过本项目，开发者可以掌握邮件自动化处理的基本流程，提升本地系统工具的开发能力，为构建更复杂的邮件管理工具打下坚实基础。
二、思路分析：项目设计与技术实现
本项目的核心目标是实现邮件的自动备份与分类。为了达成这一目标，我们需要解决以下几个关键技术点：
1. 连接IMAP邮箱服务器
使用Python标准库 imaplib 实现与邮箱服务器的连接，支持QQ邮箱、163邮箱等主流邮箱服务。
2. 邮件解析与内容提取
使用 email 模块解析邮件内容，提取邮件正文与附件。同时处理中文邮件标题和内容的解码问题，避免乱码。
3. 关键词匹配
通过正则表达式 re 模块对邮件标题和内容进行关键词匹配，筛选出需要备份的邮件。
4. 文件路径管理
使用 os 模块创建目录、保存邮件正文和附件，按日期和关键词分类存储。
5. 日志记录
使用 logging 模块记录关键操作，便于调试和追踪备份过程。
三、代码实现：Python脚本
以下是一个完整的Python脚本，用于实现智能邮件自动备份与关键词分类功能。
# 智能邮件自动备份与关键词分类器
import imaplib
import email
from email.header import decode_header
import os
from datetime import datetime
import logging
import re
# 设置日志记录
logging.basicConfig(level=logging.INFO, format='%(asctime)s, %(levelname)s - %(message)s')
# 配置信息（请根据实际情况修改）
EMAIL = "your_email@qq.com" # 邮箱地址
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):
# 解析日期
try:
date_obj = datetime.strptime(date_str[:24], "%a, %d %b %Y %H:%M:%S")
except:
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}")
# 构建邮件正文内容
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:
try:
body = part.get_payload(decode=True).decode("utf-8", errors="ignore")
except:
body = part.get_payload(decode=True).decode("gbk", errors="ignore")
break
else:
try:
body = msg.get_payload(decode=True).decode("utf-8", errors="ignore")
except:
body = msg.get_payload(decode=True).decode("gbk", 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）结合行业知识与创新视角深度思考后创作。