Python headerregistry 怎样保留地址组名称与组内收件人

我第一次需要复制邮件收件人头时，发现“能遍历到所有地址”和“能保留原来的地址组”是两件事。Python 的 email.headerregistry 已经把这两个需求分开了：读取 header.groups 可以保留组名与组内收件人，读取 header.addresses 则得到展平后的一维地址序列。

官方地址：https://docs.python.org/3/library/email/headerregistry.html

如果后续还要重建或转发带地址组的邮件头，优先保存 groups；如果只是给每个收件人做遍历、去重或统计，使用 addresses 更直接。

我为什么不再只保存 addresses

地址组的写法类似 研发组: Alice , Bob ;。组名“研发组”和组内的两个地址属于不同层次的信息。AddressHeader.groups 返回由 Group 组成的元组，每个组有 display_name 和 addresses；而 AddressHeader.addresses 会把所有组内地址放进一个扁平元组。

因此，addresses 很适合“给所有人发一份副本”这样的业务，但只保留它再写回邮件头时，原有组名和组边界就没有可直接使用的对象了。

groups 和 addresses 怎么分别读取

解析时使用默认的 EmailPolicy，地址头会交给 HeaderRegistry 生成专用对象。下面的示例只观察对象关系，不依赖本地邮件服务器。

from email import policy
from email.parser import BytesParser

raw = b"To: Dev Team: Alice , Bob ;\r\n"
raw += b"\r\n"

# 使用默认策略，让地址头返回 headerregistry 的结构化对象。
message = BytesParser(policy=policy.default).parsebytes(raw)
to_header = message["To"]

# groups 保留 Group 对象、组名和组内地址；适合后续重建邮件头。
for group in to_header.groups:
    print(group.display_name, group.addresses)

# addresses 是所有 Address 的一维视图；适合统一遍历收件人。
for address in to_header.addresses:
    print(address.display_name, address.addr_spec)

上面第一段应该关注 Group.display_name 与 Group.addresses 的对应关系，第二段只关心每个 Address 的显示名和地址规格。实际项目中，原始头的非 ASCII 组名应由邮件库按规范编码；示例中的组名只用于说明对象层级。

用 groups 原样重建地址头

需要转发、审计或生成一封相似邮件时，我会把 groups 当作结构快照保存。官方文档明确允许用 Address 与 Group 对象列表设置地址头，因此可以直接把解析结果复制到新消息。

from email.message import EmailMessage
from email import policy
from email.parser import BytesParser

source = BytesParser(policy=policy.default).parsebytes(raw)
source_to = source["To"]

# 转成列表，明确保存组的顺序、display_name 和组内 Address 对象。
saved_groups = list(source_to.groups)

rebuilt = EmailMessage(policy=policy.default)
# 直接赋值结构化对象列表，保留地址组边界。
rebuilt["To"] = saved_groups

# 需要字符串时再序列化；不要用 addresses 重新拼接来猜测组名。
serialized_to = str(rebuilt["To"])
print(serialized_to)

这里的关键不是“把字符串拼回去”，而是把 Group 和 Address 对象交给地址头工厂重新格式化。这样组名、组内成员和未分组地址都仍然有明确的对象语义。

空组、单地址和真正的地址组怎么区分

Group.display_name 为 None 时，不一定代表解析失败。对于没有组名的单个地址，headerregistry 可以用一个地址数为一的 Group 表示它；真正的地址组则有可读的组名，组内可以包含多个 Address。另外，RFC 语法允许地址组为空，所以不能把“没有组内地址”直接当成异常。

我的选择规则很简单：数据要回到邮件头，就保存 groups；数据只进入业务循环，就取 addresses。如果两种需求并存，可以同时保存二者，但把 groups 作为结构真相源，避免从展平结果反推组名。

常见问题

为什么 groups 不是普通字符串列表？

因为它需要同时表达组名和组内地址。每个元素是 Group，组内成员是 Address 对象，字符串只是最后序列化时的表现形式。

只想拿到所有邮箱地址应该用哪个属性？

用 addresses。它会按地址头中的出现位置提供展平结果，不需要你逐个展开 Group.addresses。

重建时为什么不能从 addresses 手动拼接分号？

因为展平后的地址已经不带原始组边界，手工拼接还容易遗漏编码、引用和空组等 RFC 细节。保留并重新赋值 groups 更稳妥。

这次排查后，我把 groups 看成“邮件头结构”，把 addresses 看成“遍历视图”：前者决定能否保留原貌，后者决定处理收件人是否方便。只要先确定业务是否需要回写地址组，属性选择就不会再混乱。