Python email.headerregistry.Address.addr_spec 怎样从地址对象读取纯邮箱地址
来源:17golang原创
时间:2026-11-18 14:33:31 198浏览 收藏
我在整理邮件头时遇到过一个很容易混淆的情况:Address 对象打印出来像是完整地址,例如 开发组 ,但下游接口只想要 dev@example.com。这时不要对字符串做正则截取,直接读取 Address.addr_spec。
一句话结论:addr_spec 返回邮箱地址的 username@domain 部分,并按照裸地址需要的规则完成引用;str(address) 则保留显示名和地址的完整展示形式。
本文只围绕 Python 标准库 email.headerregistry.Address 的取值边界展开,示例中的图均为静态结构说明图,不是运行截图。
先把 addr_spec、str 和 address 分开
Address 表示一个邮箱地址,可以有 display_name、username 和 domain 三部分。显示给人看的完整值适合使用 str(address);需要交给 SMTP 收件人列表、日志字段或数据库单列的纯地址,则使用 address.addr_spec。
两者的区别可以先记成一张小表:
| 入口 | 得到什么 | 适合场景 |
|---|---|---|
str(address) | 按 RFC 规则格式化的完整地址 | 展示、重新序列化邮件头 |
address.addr_spec | 正确引用后的 username@domain | 读取纯邮箱、比较或传给下游 |
address.username / domain | 地址的两个组成部分 | 需要分别处理本地部分和域名 |

从 Address 对象直接读取纯邮箱地址
已有 Address 对象时,读取方式只有一行。下面的例子特意放入带显示名的地址,用来观察完整展示值与纯地址字段的差别。
from email.headerregistry import Address
# 显示名只服务于人类阅读,addr_spec 才是裸邮箱地址
address = Address("开发组", "dev", "example.com")
print(str(address))
print(address.addr_spec)
# addr_spec 是只读属性;需要改地址时重新创建 Address
updated = Address(address.display_name, "ops", address.domain)
print(updated.addr_spec)
预期的语义是:第一行保留“开发组”和尖括号,第二行只保留 dev@example.com,重新创建的对象则得到 ops@example.com。这里的重点不是把字符串切开,而是让标准库负责地址中的引用规则。
从 From 和 To 邮件头找到 Address
实际工作里更常见的是先解析整封邮件。地址头本身不是 Address,要先根据头的形态选择单地址入口或地址列表入口:单个 From 可读取 .address,可能含多个收件人的 To 则遍历 .addresses,最后对每个对象取 .addr_spec。
from email import policy from email.parser import Parser raw = "From: 开发组\nTo: Alice , bob@example.net\n\n正文" message = Parser(policy=policy.default).parsestr(raw) # From 是单地址头,address 指向其中的 Address 对象 sender = message["From"].address.addr_spec # To 可能包含多个地址,addresses 是展平后的 Address 元组 recipients = [item.addr_spec for item in message["To"].addresses] print(sender) print(recipients)
在这段代码里,address 和 addresses 是“头对象到 Address 对象”的定位层,addr_spec 才是“Address 对象到纯字符串”的读取层。把两层混在一起,是最常见的属性访问错误。

构造参数和边界怎么判断
Address 可以直接传 username 与 domain,也可以把完整的裸地址放进 addr_spec,由标准库拆出两部分。二者不要同时混用,否则阅读代码时很难判断最终地址来自哪里。
from email.headerregistry import Address
# addr_spec 适合已经拿到完整裸地址的场景
address = Address(display_name="运维", addr_spec="ops@example.com")
# 读取结果仍然是纯地址,而 str 保留显示名
print(address.addr_spec)
print(str(address))
# 不要直接给 addr_spec 赋值;需要变更时创建新对象
try:
address.addr_spec = "new@example.com"
except AttributeError:
print("addr_spec 是不可变属性")
官方定义要求 addr_spec 符合 RFC 语法;不合规输入会在构造时失败。非 ASCII 字符可以出现在地址的相关部分并在序列化时编码,但用户名部分仍受 RFC 约束。对于国际化域名、带引号的本地部分或解析缺陷,不要自行假设字符串拼接结果,先保留 Address 对象,再在明确的边界取 addr_spec。
最后记住这三个选择
- 要展示完整地址:用
str(address)。 - 要读取不带显示名的邮箱:用
address.addr_spec。 - 要从邮件头定位对象:单地址看
header.address,多地址遍历header.addresses。
如果下游只接受纯邮箱地址,优先在 Address 层取 addr_spec,不要从带显示名的字符串中截取尖括号内容。这样既保留了标准库对引用规则的处理,也能让 From、To 等不同头形态使用一致的输出。
相关问题
addr_spec 和 username + domain 有什么区别?
前者是已经按裸地址语义组合并正确引用的字符串;后两者是对象的组成字段。需要完整地址时优先使用 addr_spec。
为什么 str(address) 不是纯邮箱地址?
因为它的职责是按 RFC 规则生成完整展示值,显示名属于地址头的有效组成部分。纯地址读取应使用专门的 addr_spec 属性。
-
369 收藏
-
344 收藏
-
464 收藏
-
327 收藏
-
349 收藏
-
470 收藏
-
文章 · python教程 | 1小时前 | 标准库 · Python教程 · Python decimal flags 精度 舍入 Context.copy_abs Decimal.copy_abs389 收藏
-
文章 · python教程 | 2小时前 | 字符串 · 标准库 · Python教程 · Python placeholder 文本截断 textwrap TextWrapper max_lines301 收藏
-
411 收藏
-
文章 · python教程 | 4小时前 | 反射 · 调试 · python · Python inspect.getmembers_static inspect.getmembers descriptor __getattr__358 收藏
-
287 收藏
-
341 收藏
-
文章 · python教程 | 9小时前 | 错误处理 · 字符集 · Python教程 · Python MIME email.utils collapse_rfc2231_value RFC 2231330 收藏
-
479 收藏
-
348 收藏
-
275 收藏
-
文章 · python教程 | 9小时前 | 日志 · 标准库 · HTTP · python · Python HTTPS post logging.handlers.HTTPHandler HTTPHandler 远程日志262 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 立即学习 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 立即学习 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 立即学习 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 立即学习 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 立即学习 485次学习