Python email.headerregistry.Address.addr_spec 怎样从地址对象读取纯邮箱地址
我在整理邮件头时遇到过一个很容易混淆的情况: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 属性。
Go testing/iotest.HalfReader 怎样模拟每次只能读取部分数据的输入
- 上一篇
- Go testing/iotest.HalfReader 怎样模拟每次只能读取部分数据的输入
- 下一篇
- Go go/types.TypeParam.Constraint 怎样取得泛型类型参数的约束类型
-
- 文章 · python教程 | 1小时前 | Python教程 · Python memoryview memoryview.toreadonly bytearray 只读视图 缓冲区协议
- Python memoryview.toreadonly 怎样生成只读视图而不复制底层数据
- 470浏览 收藏
-
- 文章 · python教程 | 1小时前 | 标准库 · Python教程 · Python decimal flags 精度 舍入 Context.copy_abs Decimal.copy_abs
- Python decimal.Context.copy_abs 怎样取绝对值而不受当前精度舍入影响
- 389浏览 收藏
-
- 文章 · python教程 | 2小时前 | 字符串 · 标准库 · Python教程 · Python placeholder 文本截断 textwrap TextWrapper max_lines
- Python textwrap.TextWrapper.placeholder 怎样为截断后的段落设置结束标记
- 301浏览 收藏
-
- 文章 · python教程 | 3小时前 | python · Python 参数绑定 inspect BoundArguments apply_defaults
- Python inspect.BoundArguments.apply_defaults 怎样给已绑定参数补上默认值
- 411浏览 收藏
-
- 文章 · python教程 | 4小时前 | 反射 · 调试 · python · Python inspect.getmembers_static inspect.getmembers descriptor __getattr__
- Python inspect.getmembers_static 怎样列出成员而不触发动态属性查找
- 358浏览 收藏
-
- 文章 · python教程 | 9小时前 | python · SQLite · Python sqlite3 Connection.interrupt 长查询 OperationalError
- Python sqlite3.Connection.interrupt 怎样从线程中止长查询
- 287浏览 收藏
-
- 文章 · python教程 | 9小时前 | 错误处理 · 字符集 · Python教程 · Python MIME email.utils collapse_rfc2231_value RFC 2231
- Python collapse_rfc2231_value 怎样还原带字符集的参数
- 330浏览 收藏
-
- 文章 · python教程 | 9小时前 |
- Python dataclasses.fields 怎样读取数据类的字段元数据
- 348浏览 收藏
-
- 文章 · python教程 | 9小时前 | python · Python 批量处理 迭代器 itertools.batched
- Python itertools.batched 怎样把可迭代对象分成固定大小的批次
- 275浏览 收藏
-
- 文章 · python教程 | 9小时前 | 日志 · 标准库 · HTTP · python · Python HTTPS post logging.handlers.HTTPHandler HTTPHandler 远程日志
- Python logging.handlers.HTTPHandler 怎样把日志发送到 HTTP 服务
- 262浏览 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 485次学习
-
- PubMedQA
- 深入了解PubMedQA生物医学问答数据集,涵盖其核心功能、使用方法及在临床决策、药物研发等场景的应用,助力提升NLP模型性能。
- 1095次使用
-
- H2O EvalGPT
- H2O EvalGPT是H2O.ai推出的开源LLM评估平台,提供详细的大模型性能排行榜、行业特定基准测试及A/B测试功能,助您快速选择最适合项目的高性能大语言模型。
- 1091次使用
-
- LMArena
- LMArena是加州大学伯克利分校推出的AI模型匿名评测平台。通过盲测投票机制,用户可对比不同大模型回答并生成实时排行榜,助力开发者优化模型及用户选择最佳AI工具。
- 1256次使用
-
- HELM
- 深入了解斯坦福推出的HELM(Holistic Evaluation of Language Models)大模型评测体系。本文解析其核心功能、安装配置步骤及应用场景,涵盖准确性、公平性、鲁棒性等多维度指标,助力开发者全面优化语言模型性能。
- 1197次使用
-
- MMBench
- MMBench是由上海人工智能实验室等机构联合推出的多模态基准测试平台,提供细粒度能力评估、大规模数据集及VLMEvalKit工具。本文详细介绍其核心功能、安装使用方法及应用场景,助力开发者全面评估多模态模型性能。
- 1046次使用
-
- GScript 编写标准库示例详解
- 2022-12-30 369浏览
-
- 关于Golang标准库flag的全面讲解
- 2023-02-25 344浏览
-
- Golang标准库unsafe源码解读
- 2022-12-29 464浏览
-
- 快速掌握Go语言HTTP标准库的实现方法
- 2022-12-30 327浏览
-
- 解析golang 标准库template的代码生成方法
- 2022-12-24 349浏览

