使用win32com.client连接Outlook必须在Windows上运行且依赖本地安装并启动的Outlook客户端，需确保Python与Outlook架构一致（同为32或64位），首次运行前应手动打开Outlook；获取未读邮件应使用Items.Restrict("[Unread] = true")而非遍历判断Unread属性；解析正文优先用HTMLBody配合BeautifulSoup("html.parser")；标记已读必须调用mail.Unread=False后立即mail.Save()。
用 win32com.client 连 Outlook 必须在 Windows 上运行
Outlook 的 COM 接口只支持 Windows，且依赖本地安装的 Outlook 客户端（不是网页版或 Outlook for Mac）。脚本运行时，Outlook.exe 进程必须存在（哪怕最小化），否则 Dispatch("Outlook.Application") 会抛出 pywintypes.com_error。常见错误信息是：(-2147221005, 'Invalid class string', None, None) —— 这通常意味着 Outlook 没装、没启动，或 Python 是 64 位而 Outlook 是 32 位（或反过来）。
实操建议：
- 确认 Python 和 Outlook 架构一致（都为 32 位或都为 64 位），可通过
platform.architecture()和 Outlook 关于对话框核对 - 首次运行前手动打开一次 Outlook，避免首次启动卡在配置向导
- 不要在无桌面会话的 Windows 服务或计划任务中直接调用；如需后台运行，改用任务计划程序触发交互式会话
获取未读邮件时，Items.Restrict 比循环判断 Unread == True 更可靠
直接遍历收件箱所有邮件再检查 mail.Unread 属性，不仅慢（尤其邮箱大时），还容易漏掉刚被其他客户端标记为已读的邮件——因为 Unread 是缓存值。正确做法是用 MAPI 层过滤器，通过 Restrict("[Unread] = True") 让 Outlook 后端直接返回结果。
注意点：
立即学习“Python免费学习笔记（深入）”；
- 过滤字符串必须用英文方括号包裹字段名，且值区分大小写：
"[Unread] = true"有效，"Unread = True"无效 -
Restrict返回的是新Items集合，不是原集合的视图，但不自动排序；如需按时间倒序，得额外调用.Sort("[ReceivedTime]", True) - 某些字段（如
[SenderEmailAddress]）在 Exchange 账户下可能为空，优先用[SenderName]或.Sender.Address（后者需调用.Sender.GetExchangeUser().PrimarySmtpAddress才稳定）
解析邮件正文时，mail.Body 和 mail.HTMLBody 行为差异明显
纯文本正文用 mail.Body 最安全；但若邮件含格式、图片或超链接，mail.Body 会丢失结构，甚至把 HTML 标签当普通字符输出。此时应优先尝试 mail.HTMLBody，再用轻量库（如 BeautifulSoup）提取文本或链接。
常见陷阱：
-
mail.HTMLBody可能包含 Outlook 特有样式（如xmlns:o命名空间），BeautifulSoup(html, "html.parser")能处理，但"lxml"解析器有时会报错，建议显式指定"html.parser" - 附件路径在
HTMLBody中是 CID 引用（如<img src="cid:xxx">），无法直接访问；真实附件需从mail.Attachments集合中单独保存 - 邮件正文编码问题极少出现（Outlook 自动处理），但若遇到乱码，不要手动 decode —— 说明原始内容本身异常，应跳过或记录日志
标记邮件为已读后务必调用 mail.Save()，否则下次仍会被读取
设置 mail.Unread = False 只是修改内存对象，不持久化到 Outlook 数据库。必须紧接着调用 mail.Save()，否则下次脚本运行时，这封邮件还会出现在 Restrict("[Unread] = True") 结果里。
更稳妥的做法：
- 在成功解析并处理完邮件后，再执行
mail.Unread = False和mail.Save() - 如果处理过程可能失败（如网络请求超时），用
try/except包裹核心逻辑，并在finally中不标记已读，避免“误吞”邮件 - 避免批量调用
Save()（比如循环里每封都 Save），会显著拖慢速度；可考虑用time.sleep(0.05)间隔，缓解 Outlook COM 调用压力
真正麻烦的不是连上 Outlook 或读到邮件，而是账户类型混杂（POP3/IMAP/Exchange）、权限策略（如公司禁用 COM 自动化）、以及 Outlook 后台静默更新导致接口微变。建议先用最简脚本验证基础连通性，再逐步加解析和状态管理逻辑。
