Python如何批量读取未读邮件并自动分拣下载对应附件-Python教程-PHP中文网

连不上邮箱主因是服务商禁用IMAP或未配应用专用密码：Gmail需开两步验证并用应用专用密码；QQ邮箱须网页端开启IMAP/SMTP并用授权码；Outlook.com需启用IMAP或允许低安全应用。

python如何批量读取未读邮件并自动分拣下载对应附件

绝大多数“连不上”的根本原因不是代码写错，而是邮箱服务商禁用了 IMAP 或未开启应用专用密码。Gmail、Outlook.com、QQ 邮箱默认关闭 IMAP，且现代登录已不支持明文密码直连。

实操建议：

Gmail 必须开启「两步验证」后生成「应用专用密码」，用它代替账户密码；在 imaplib.IMAP4_SSL('imap.gmail.com', 993) 中传入该密码
QQ 邮箱需在网页端「设置 → 账户 → IMAP/SMTP 服务」手动开启，并勾选「IMAP/SMTP 服务」，同时使用「授权码」而非登录密码
Outlook.com（Hotmail）需启用「IMAP」并在安全设置中允许“较不安全的应用”，或改用 Microsoft Graph API（更复杂但更合规）
连接前加异常捕获：try...except imaplib.IMAP4.error as e:，错误信息如 [AUTHENTICATIONFAILED] 或 LOGIN failed 直接指向权限问题

IMAP 的默认文件夹名因语言/服务商而异：INBOX 是通用名，但部分邮箱（如 QQ 邮箱中文界面）实际使用 收件箱，且 UNSEEN 不会跨子文件夹匹配——它只查当前 SELECT 的文件夹。

实操建议：

先用 mail.list() 打印所有文件夹，确认目标文件夹的准确名称（注意可能含空格或中文）
用 mail.select('INBOX', readonly=False) 显式指定文件夹并允许修改标志（后续标记已读需要）
搜索时加上字符集声明：mail.search('UTF-8', 'UNSEEN')，避免中文邮箱名或主题导致解析失败
某些企业邮箱（如网易企业邮箱）对 UNSEEN 支持不稳定，可退而求其次用时间范围：mail.search(None, '(SINCE "01-Jan-2024")')

邮件头中的附件名（Content-Disposition）常为 filename*=UTF-8''xxx 编码格式，直接取值会是乱码；且不同客户端可能发同名附件（如 report.pdf），不处理就会被后发覆盖。

让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限

下载

实操建议：

用 email.header.decode_header() 解析附件名，再用 ''.join([bytes(part[0]).decode(part[1] or 'utf-8') for part in decoded]) 拼接
保存前检查是否存在同名文件：if os.path.exists(filepath): filepath = f"{name}_{int(time.time())}{ext}"
不要依赖 part.get_filename() 单一方法——有些附件只有 part.get_param('name') 有值，需两者 fallback
二进制内容必须用 part.get_payload(decode=True) 获取原始字节，否则 base64 未解码会导致 PDF 打不开

按发件人、主题关键词、附件扩展名分拣是刚需，但把路径写死（如 if 'invoice' in subject: save_to = './invoices/'）会让维护成本飙升。规则应可配置、可扩展。

实操建议：

用字典定义规则：例如 rules = [{'keywords': ['invoice', '账单'], 'exts': ['.pdf', '.xlsx'], 'dir': 'invoices'}, ...]
匹配时统一转小写 + 去空格：subject.lower().replace(' ', '')，避免大小写或空格干扰
优先按附件扩展名分拣（更可靠），再 fallback 到主题/发件人；避免仅凭主题“采购”就归入采购目录——可能是采购部发的会议纪要
每次下载后调用 mail.store(uid, '+FLAGS', '\Seen') 标记已读，防止重复处理；但注意 UID 是服务器唯一标识，需用 mail.uid('SEARCH', None, 'UNSEEN') 模式获取（比普通 SEARCH 更稳定）

附件分拣真正的复杂点不在代码，而在规则歧义——比如“合同”可能出现在法务邮件、销售邮件、HR 邮件里，对应不同目录。上线前必须用真实历史邮件样本跑一遍规则，手工校验误分案例。