Python mailbox.Maildir 怎样区分新邮件与已读邮件

Python mailbox.Maildir 应分别判断“是否位于 new 目录”和“是否带 S 已读标记”：前者用 msg.get_subdir() == "new"，后者用 "S" in msg.get_flags()。cur 里的邮件仍可能未读，因此不能拿 new 与 cur 直接划分未读、已读。

Python 官方文档地址：https://docs.python.org/3/library/mailbox.html

把投递位置与阅读状态分成两个字段

设想一个本地邮件整理工具：用户打开邮箱后，收件计数下降了，但并没有逐封阅读。若程序把 cur 的数量当已读数量，就会错误地把“邮箱已经被访问”解释成“邮件已经读过”。这是两个字段被压成一个状态枚举造成的问题。

Maildir 的目录位置与邮件标记分别承载信息。new 表示新投递位置，cur 表示当前邮件位置；标准标记中的 S 表示已读。MaildirMessage 文档 明确解释了 cur 邮件未必已读。本文将这一语义建模为两个布尔字段，供列表展示和计数分别使用。

最后一行用于表达异常或其他客户端维护出来的组合，不建议业务代码看到它就自动修正。统计口径应先约定：新投递计数取 is_new，标准已读计数取 is_seen；两项不能互相取反。

只读扫描并返回两个布尔值

下面的原创示例读取已有的可信本地 Maildir，返回状态记录，不移动邮件、不设置 S。代码未在本文制作中执行，打印语句只是供读者观察字段，不附虚构运行输出。

import mailbox
from pathlib import Path

def collect_states(maildir_path):
    # 只打开已有邮箱；路径应来自可信的本地配置。
    box = mailbox.Maildir(str(Path(maildir_path)), create=False)
    records = []
    try:
        for key in box.iterkeys():
            try:
                msg = box.get_message(key)
            except KeyError:
                # 其他客户端可能在遍历后删除邮件，跳过已消失的键。
                continue
            info = msg.get_info()
            records.append({
                "key": key,
                "subdir": msg.get_subdir(),
                "is_new": msg.get_subdir() == "new",
                "is_seen": "S" in msg.get_flags(),
                # 空 info 可按无标记处理，其他实验格式留给调用方判断。
                "standard_info": not info or info.startswith("2,"),
            })
    finally:
        box.close()
    return records

if __name__ == "__main__":
    # 示例路径由读者替换；不存在或权限不足的错误交给调用者处理。
    for row in collect_states("./sample-maildir"):
        print(row)

保留 subdir 有利于解释列表中的分类，保留 key 则便于后续按同一邮箱的键操作。本文不读取主题和正文，因为这道题只需要状态元数据。程序也不通过 Date 邮件头推算“新邮件”：发送时间与当前是否已读不是同一个问题。

standard_info 是本例增加的业务字段，用于区分标准标记和实验 info。若它为假，get_flags() 的空结果不应被报表过度解释为“确认未读”；可以展示“阅读状态未识别”，由业务决定是否计入未读。文件系统权限错误等异常没有被吞掉，调用方应将扫描失败与空邮箱区分开。

标为已读时明确写回同一个 key

读取出来的消息对象不是持久化记录的实时引用。应用需要把变更后的对象写回邮箱。下面的函数只负责一封邮件，要求调用者传入同一个 Maildir 的有效 key；它把位置设为 cur，并增加 S，而不是清空其他标记。

import mailbox

def mark_seen(maildir_path, key):
    box = mailbox.Maildir(maildir_path, create=False)
    try:
        msg = box.get_message(key)  # 键失效时抛出 KeyError，不假装写入成功。
        info = msg.get_info()
        if info and not info.startswith("2,"):
            raise ValueError("实验 info 需要单独的转换规则")
        msg.set_subdir("cur")
        msg.add_flag("S")  # 保留 F、R 等已有标准标记。
        box[key] = msg  # 修改对象后明确写回邮箱，才更新底层消息。
    finally:
        box.close()

这份写法刻意使用 add_flag("S")。如果改成 set_flags("S")，已有其他标准标记会被替换。实验 info 则先拒绝转换，防止把应用尚未理解的数据直接覆盖掉。关于消息副本和赋值语义，可参考 Mailbox 接口说明。

用反例确定统计口径

最小的反例就是 cur 中没有 S 的邮件。只要报表把它列为已读，判断规则就混淆了位置和阅读标记。反过来，只统计 new 也无法覆盖所有未读邮件，列表应同时展示位置与阅读状态。

并发也会影响结果：遍历时某封邮件消失可以跳过，但一次遍历得到的计数不应被称为邮箱的事务快照。写入函数的“读对象、修改、写回”同样不等于跨客户端的原子状态合并；有其他客户端同时修改时，应由调用方协调，避免旧对象覆盖新变化。不要把 Maildir 的文件存储设计理解为应用级事务保证。

本文只处理传入的一个 Maildir。若需要统计归档文件夹，应显式取得对应文件夹并各自扫描，不把父目录扫描结果当作整个账户。服务端同步状态、客户端界面缓存和本地文件夹状态也需分开定义。

常见问题

调用 get_message 会自动把邮件标成已读吗？

本例没有执行任何状态写回。读取与已读操作分开，能让预览、索引和实际阅读采用不同策略；不要把一次读取当作用户阅读的证明。

为什么移动到 cur 后还是未读？

位置变化并不替代 S 标记。是否已读仍需检查标记，本文的 mark_seen 函数才明确同时设置这两个信息。

报表应该直接显示“新邮件”还是“未读”？

如果指标统计 new，命名为“新投递”更清楚；如果按标准标记中是否含 S 分类，则采用“已读／未读”，并对未识别的 info 单列状态。名称应忠实于程序实际采用的字段。