Python EmailMessage 重复头字段：再赋一次值，为什么旧值并没有被替换
整理邮件元数据时，把msg[字段名]写两次，看起来与普通字典更新相同。但EmailMessage允许某些头字段重复出现，赋值可能是在末尾追加。只读一次msg[字段名]又拿到一个字符串，很容易让第二份值在检查中消失。需要先按多值结构理解它的接口。
下面用虚构的X-Trace头做实验，在CPython 3.12.14的默认EmailMessage策略下实跑。保存为demo.py，运行python3 demo.py即可。它不登录邮箱、不读真实邮件、不发送任何消息，只操作一个内存对象；示例字段值也不代表可信追踪证据。
AI模型生成概念图：同形卡片可以在架上保留多张，替换工具只触及最先的一张，用于比喻重复头字段和单项替换。
把全部值和单次读取同时打印
先分别以X-Trace和x-trace写入first、second，再用全大写名称读取全部值。随后替换第一项、删除全部同名项并重建，最后用Subject检验默认策略中的单值限制。标准策略返回的头对象通过str转成显示文字，便于和固定预期比较。
完整可运行程序
from email.message import EmailMessage
msg = EmailMessage()
msg["X-Trace"] = "first"
msg["x-trace"] = "second"
all_values = [str(value) for value in msg.get_all("X-TRACE")]
assert all_values == ["first", "second"]
single = str(msg["X-Trace"])
assert single in all_values
print("all trace values:", all_values)
print("single lookup in this run:", single)
print("header names:", msg.keys())
msg.replace_header("X-TRACE", "revised")
values = [str(value) for value in msg.get_all("x-trace")]
assert values == ["revised", "second"]
assert msg.keys() == ["X-Trace", "x-trace"]
print("replace first only:", values)
del msg["X-Trace"]
assert msg.get_all("x-trace", []) == []
msg["X-Trace"] = "only"
assert [str(x) for x in msg.get_all("x-trace")] == ["only"]
print("delete then add:", [str(x) for x in msg.get_all("x-trace")])
assert msg["missing"] is None
print("missing header:", msg["missing"])
msg["Subject"] = "one"
try:
msg["Subject"] = "two"
except ValueError:
print("duplicate Subject:", "ValueError")
else:
raise AssertionError("this policy should limit Subject to one")本次实际输出（以下为结果，不是程序）
all trace values: ['first', 'second'] single lookup in this run: first header names: ['X-Trace', 'x-trace'] replace first only: ['revised', 'second'] delete then add: ['only'] missing header: None duplicate Subject: ValueError
像字典的写法不等于字典覆盖
all trace values输出first和second两项，header names仍保留X-Trace与x-trace两个原始拼写。读取时大小写不影响名称匹配，但结构中既可以保留字段原始大小写，也可以保留重复出现的位置。不能以名称字面大小写不同，就把它们当作两个独立语义字段。
single lookup in this run输出first，只是本次运行观察。官方接口没有承诺多值情况下单次读取究竟选择哪一项，因此程序仅断言它属于全部值，没有把“永远取第一项”写成可依赖合同。只要任务需要完整性，就应使用get_all，并定义多值时该保留、合并还是拒绝。
replace_header与全部重建覆盖不同范围
replace first only得到revised与second，说明replace_header只改了首个匹配项，同时原来的字段顺序和大小写仍在。它适合明确只想替换一个已存在头的位置；不能因为名字里有replace，就认为其余同名项已经被清理。
del msg[字段名]移除所有匹配项，之后再追加only才得到只有一项的结果。删除再添加也会把新头放到末尾，这与保留原位置的单项替换并不一样。归档或重写流程若关心头顺序，应先决定需要哪一种行为，并在操作前后比较整个字段列表。
缺失与重复需要独立政策
missing header输出None，而不是抛出KeyError；get_all也能通过第二参数在缺失时返回空列表。这个接口差别会影响从普通dict迁移来的校验代码：只写except KeyError，无法证明缺少的邮件头已被检测。需要按返回值和实际业务要求处理。
Subject的第二次赋值触发ValueError，是本次默认策略对该字段数量的限制。不要把X-Trace的可重复行为推广到每个标准字段，也不要把某个策略下的异常永久当作通用覆盖方法。若确实要替换Subject，可以明确调用替换操作，或按约定删除后重建，并在目标Python与策略组合上验证。
完整读取不代表邮件内容可信
这里的X-Trace由程序自己构造，所以只用于观察容器语义。真实输入中，头字段可能来自不同系统甚至不可信发送方。把所有值保存下来有助于保留结构，但不能仅凭字段存在、名称相似或数量正确就确认身份与来源；可信判断属于另一层。
示例也没有讨论MIME正文、附件解析或发送格式。一次头部改写若用于实际转发，还需按邮件标准、所用策略和业务要求验证序列化结果。最低限度应像本例一样保留追加、单项替换、全部删除、字段缺失和受限重复五种样本，避免只用一封干净邮件检查。
参考资料
资料核验日期：2026年10月2日。以上输出来自文中固定输入的本地实跑，程序退出码为0。
