连不上邮箱主因是服务商禁用IMAP或未配应用专用密码：Gmail需开两步验证并用应用专用密码；QQ邮箱须网页端开启IMAP/SMTP并用授权码；Outlook.com需启用IMAP或允许低安全应用。
用 imaplib 连不上邮箱？先确认协议和权限
绝大多数“连不上”的根本原因不是代码写错，而是邮箱服务商禁用了 IMAP 或未开启应用专用密码。Gmail、Outlook.com、QQ 邮箱默认关闭 IMAP，且现代登录已不支持明文密码直连。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 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直接指向权限问题
SEARCH UNSEEN 找不到未读邮件？检查文件夹和编码
IMAP 的默认文件夹名因语言/服务商而异：INBOX 是通用名，但部分邮箱（如 QQ 邮箱中文界面）实际使用 收件箱，且 UNSEEN 不会跨子文件夹匹配——它只查当前 SELECT 的文件夹。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 先用
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 UI 自动化技能包 —— 用 Python 控制你的 Mac
下载
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 用
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/'）会让维护成本飙升。规则应可配置、可扩展。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 用字典定义规则：例如
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 邮件里，对应不同目录。上线前必须用真实历史邮件样本跑一遍规则，手工校验误分案例。
