在日常工作中，我们经常需要从邮箱里下载特定日期范围内的邮件附件。想象一下，你需要收集过去几个月内客户发送的报价单、合同等附件，如果手动一个个去查找和下载，那得花费多少时间和精力呀！今天就给大家分享一个用 Python 实现的自动化下载邮件附件的代码，让你轻松搞定这个繁琐的任务。

代码背景与需求理解

在处理大量邮件时，我们常常面临着在指定日期范围内查找并下载附件的需求。例如，财务人员需要每月收集特定时间段内的发票附件，运营人员需要获取某个活动期间的反馈文件等。手动操作不仅效率低下，还容易出错。而使用 Python 编写一个自动化脚本，就可以让计算机帮我们快速准确地完成这些任务。

代码功能概述

这份代码的主要功能是下载指定日期范围内的邮件附件，并按照邮件的日期将附件分类保存到本地目录。它支持自定义开始日期和结束日期，还能处理邮件头信息的解码，确保中文主题和附件名能正确显示。

代码详细解读

1. 导入必要的库

import imaplib
import email
import os
import argparse
from datetime import datetime, timedelta
from email.header import decode_header
import pandas as pd

这里导入了多个 Python 库，imaplib 用于连接邮箱服务器，email 用于解析邮件内容，os 用于文件和目录操作，argparse 用于解析命令行参数，datetime 和 timedelta 用于日期处理，decode_header 用于解码邮件头信息，pandas 用于读取 Excel 文件。

2. 配置参数解析

def parse_args():
    parser = argparse.ArgumentParser(description='下载指定日期范围内的邮件附件')
    parser.add_argument('--start', required=True, help='开始日期 (格式: YYYY-MM-DD)')
    parser.add_argument('--end', required=True, help='结束日期 (格式: YYYY-MM-DD)')
    parser.add_argument('--user', required=True, help='邮箱账号')
    parser.add_argument('--password', required=True, help='邮箱密码/授权码')
    return parser.parse_args()

这个函数使用 argparse 库来解析命令行参数，用户需要提供开始日期、结束日期、邮箱账号和密码 / 授权码。

3. 解码邮件头信息

def decode_mime_header(header):
    try:
        decoded = decode_header(header)
        return ''.join(
            part.decode(encoding or 'gbk') if isinstance(part, bytes) else part
            for part, encoding in decoded
        )
    except:
        return header

由于邮件头信息可能包含中文等非 ASCII 字符，需要进行解码处理。这个函数会尝试对邮件头进行解码，如果解码失败则返回原始信息。

4. 主下载函数

def download_attachments(start_date, end_date, email_user, email_pass, win):
    ATTACHMENT_BASE_DIR = './attachments'
    IMAP_SERVER = 'imap.163.com'

    try:
        # 连接邮箱
        mail = imaplib.IMAP4_SSL(IMAP_SERVER)
        mail.login(email_user, email_pass)
        mail.select('inbox')

        # 日期格式转换
        imap_start = datetime.strptime(start_date, '%Y-%m-%d').strftime('%d-%b-%Y')
        imap_end = (datetime.strptime(end_date, '%Y-%m-%d') + timedelta(days=1)).strftime('%d-%b-%Y')

        search_criteria = f'(SINCE "{imap_start}" BEFORE "{imap_end}")'
        print(f"搜索范围: {start_date} 至 {end_date} | IMAP条件: {search_criteria}")
        win.refresh()
        # 搜索邮件
        _, data = mail.search(None, search_criteria)
        email_ids = data[0].split()
        print(f"找到 {len(email_ids)} 封邮件")
        win.refresh()
        # 处理邮件
        for email_id in email_ids:
            _, data = mail.fetch(email_id, '(RFC822)')
            msg = email.message_from_bytes(data[0][1])

            # 解析邮件信息
            date = datetime.strptime(msg['Date'][:24], '%a, %d %b %Y %H:%M:%S')
            subject = decode_mime_header(msg['Subject'])
            print(f"\n[{date}] 主题: {subject}")
            win.refresh()
            # 检查附件
            attachments = [
                (decode_mime_header(part.get_filename()), part)
                for part in msg.walk()
                if part.get_filename() and part.get('Content-Disposition')
            ]

            if not attachments:
                print("无附件，跳过")
                win.refresh()
                continue

            # 创建日期目录
            date_dir = os.path.join(ATTACHMENT_BASE_DIR, date.strftime('%Y-%m-%d'))
            os.makedirs(date_dir, exist_ok=True)
            print(f"保存到: {date_dir}")
            win.refresh()
            # 保存附件
            for filename, part in attachments:
                safe_name = ''.join(c for c in filename if c.isalnum() or c in ' .-_,')
                path = os.path.join(date_dir, safe_name)
                with open(path, 'wb') as f:
                    f.write(part.get_payload(decode=True))
                print(f" {safe_name}")
                win.refresh()
    except Exception as e:
        print(f"错误: {str(e)}")
        win.refresh()
    finally:
        mail.close()
        mail.logout()

这个函数是整个代码的核心，它完成了以下几个主要步骤：

• 连接到邮箱服务器并登录。
• 根据用户提供的开始日期和结束日期，生成 IMAP 搜索条件。
• 搜索符合条件的邮件，并获取邮件 ID。
• 遍历每封邮件，解析邮件信息，检查是否有附件。
• 如果有附件，创建以邮件日期命名的目录，并将附件保存到该目录下。

5. 主函数

def main(date1, date2, win):
    df = pd.read_excel(r'./邮箱信息.xlsx', sheet_name=0, dtype=str)
    df_dict = df.set_index("名称")["值"].to_dict()
    # 邮箱配置信息
    email_user = df_dict.get('用户名')
    email_pass = df_dict.get('密码')
    # imap_server = df_dict.get('IMAP_SEVER')
    start_date = date1
    end_date = date2
    download_attachments(start_date, end_date, email_user, email_pass, win)

主函数从 Excel 文件中读取邮箱账号和密码，然后调用 download_attachments 函数进行附件下载。

6. 脚本入口

if __name__ == '__main__':
    # args = parse_args()
    os.makedirs('./attachments', exist_ok=True)

    # print(f"开始处理 {args.user} 的邮件...")
    # download_attachments(args.start, args.end, args.user, args.password)
    download_attachments('2024-12-01', '2025-04-13', 'demo@163.com', 'password')
    print("\n处理完成！附件保存在 ./attachments 目录")

在脚本的入口处，创建了保存附件的基础目录，并调用 download_attachments 函数进行附件下载。

使用方法与注意事项

使用方法

1. 将代码保存为一个 Python 文件，例如 download_emails.py。
2. 准备一个 邮箱信息.xlsx 文件，包含 名称 和 值 两列，分别填写 用户名 和 密码。
3. 修改脚本中的开始日期和结束日期，或者通过命令行参数传入。
4. 运行脚本，等待附件下载完成。

注意事项

• 确保你的邮箱开启了 IMAP 服务，并获取了正确的授权码。
• 默认邮箱能查询下载30日的邮件，也可查询所有时间段的，需要在邮箱中设置
• 代码中使用的是 163 邮箱的 IMAP 服务器，如果你使用的是其他邮箱，需要修改 IMAP_SERVER 的值。
• 附件保存的目录为 ./attachments，你可以根据需要修改 ATTACHMENT_BASE_DIR 的值。
• 本代码只适合163邮箱，QQ邮箱可以实现私信留言。
• 'password'不是邮箱的密码，在设置开启IMAP的时候邮箱系统自动生成的密码。

总结

通过使用这个 Python 脚本，我们可以轻松地实现邮件附件的自动化下载，大大提高工作效率。代码的逻辑清晰，易于理解和修改，你可以根据自己的需求进行扩展，例如添加更多的筛选条件、处理不同类型的邮件等。希望这个代码能帮助你解决邮件附件处理的烦恼，让你的工作更加轻松愉快！

以上就是关于这个自动化下载邮件附件代码的详细介绍，如果你有任何问题或建议，欢迎在评论区留言交流。