使用Pywin32的Restrict方法筛选Outlook收件人字段遇阻

问题原因 #

你用[To]作为筛选条件失效，是因为Outlook的To字段存储的是显示名称+邮箱地址的组合字符串（比如"Test User <test@test.com>"），直接匹配纯邮箱地址无法命中。

可行解决方案 #

方案1：精准匹配收件人SMTP地址（推荐） #

使用DASL语法的urn:schemas:httpmail:toemail字段，直接匹配收件人的SMTP地址，筛选条件更精准：

# 单个收件人筛选
to_filter = "@SQL=\"urn:schemas:httpmail:toemail\" = 'target@test.com'"

# 结合发件人筛选的组合条件
combined_filter = f"([SenderEmailAddress] = 'test1@test.com' OR [SenderEmailAddress] = 'test2@test.com') AND {to_filter}"

方案2：模糊匹配To字段中的邮箱地址 #

如果不需要绝对精准，可通过LIKE模糊匹配To字段中包含的邮箱地址：

# 传统语法模糊匹配
to_filter = "[To] LIKE '%test@test.com%'"

# DASL语法模糊匹配（更可靠）
to_filter = "@SQL=\"urn:schemas:httpmail:to\" LIKE '%test@test.com%'"

修改后的完整代码示例 #

def parse_mail():
    global mail_MIs
    pythoncom.CoInitialize()
    outlook = Client.Dispatch("outlook.Application")

    namespace = outlook.GetNamespace('MAPI')

    inbox = namespace.Folders('bla@blabla.com').Folders('Inbox')
    year2022_folder = inbox.Folders[1].Folders

    # 定义组合筛选条件：发件人为指定邮箱 且 收件人为目标邮箱
    combined_filter = "([SenderEmailAddress] = 'test1@test.com' OR [SenderEmailAddress] = 'test2@test.com') AND @SQL=\"urn:schemas:httpmail:toemail\" = 'target@test.com'"

    for month_folder in year2022_folder:
        filtered_items = month_folder.Items.Restrict(combined_filter)
        for item in filtered_items:
            # 执行你需要的操作，比如打印邮件信息
            print(f"主题：{item.Subject} | 发件人：{item.SenderEmailAddress} | 收件人：{item.To}")

Restrict常用筛选字段补充 #

给你整理几个常用的筛选字段，方便后续使用：

• SenderEmailAddress：发件人SMTP地址
• Subject：邮件主题
• ReceivedTime：邮件接收时间（可用于时间范围筛选，比如[ReceivedTime] >= '2022/01/01'）
• urn:schemas:httpmail:toemail：To字段的SMTP地址（精准匹配收件人）
• urn:schemas:httpmail:ccemail：CC字段的SMTP地址（精准匹配抄送人）

内容的提问来源于stack exchange，提问作者homunculus