当前位置:首页 > 文章列表 > 文章 > python教程 > Python email.headerregistry.Address.addr_spec 怎样从地址对象读取纯邮箱地址

Python email.headerregistry.Address.addr_spec 怎样从地址对象读取纯邮箱地址

来源:17golang原创 2026-11-18 14:33:31 0浏览 收藏

我在整理邮件头时遇到过一个很容易混淆的情况: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 对象中显示名、用户名、域名与 addr_spec 的静态关系说明图
图1:结构说明图,展示 Address 的显示名、用户名、域名和纯邮箱地址之间的静态关系。

从 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 对象到纯字符串”的读取层。把两层混在一起,是最常见的属性访问错误。

邮件 From 和 To 头对象定位到 Address 再读取 addr_spec 的静态结构图
图2:结构说明图,展示邮件头、单地址或地址集合、Address 对象与 addr_spec 的静态关系。

构造参数和边界怎么判断

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 属性。

版本声明
本文转载于:17golang原创 如有侵犯,请联系study_golang@163.com删除
Go testing/iotest.HalfReader 怎样模拟每次只能读取部分数据的输入Go testing/iotest.HalfReader 怎样模拟每次只能读取部分数据的输入
上一篇
Go testing/iotest.HalfReader 怎样模拟每次只能读取部分数据的输入
Go go/types.TypeParam.Constraint 怎样取得泛型类型参数的约束类型
下一篇
Go go/types.TypeParam.Constraint 怎样取得泛型类型参数的约束类型
查看更多
最新文章
查看更多
课程推荐
  • 前端进阶之JavaScript设计模式
    前端进阶之JavaScript设计模式
    设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
    543次学习
  • GO语言核心编程课程
    GO语言核心编程课程
    本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
    516次学习
  • 简单聊聊mysql8与网络通信
    简单聊聊mysql8与网络通信
    如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
    500次学习
  • JavaScript正则表达式基础与实战
    JavaScript正则表达式基础与实战
    在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
    487次学习
  • 从零制作响应式网站—Grid布局
    从零制作响应式网站—Grid布局
    本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
    485次学习
查看更多
AI推荐
  • PubMedQA数据集详解:生物医学问答基准、功能与应用指南
    PubMedQA
    深入了解PubMedQA生物医学问答数据集,涵盖其核心功能、使用方法及在临床决策、药物研发等场景的应用,助力提升NLP模型性能。
    1095次使用
  • H2O EvalGPT:开源LLM大模型评估与排行榜工具
    H2O EvalGPT
    H2O EvalGPT是H2O.ai推出的开源LLM评估平台,提供详细的大模型性能排行榜、行业特定基准测试及A/B测试功能,助您快速选择最适合项目的高性能大语言模型。
    1091次使用
  • LMArena是什么?伯克利AI模型评估平台使用指南与功能解析
    LMArena
    LMArena是加州大学伯克利分校推出的AI模型匿名评测平台。通过盲测投票机制,用户可对比不同大模型回答并生成实时排行榜,助力开发者优化模型及用户选择最佳AI工具。
    1256次使用
  • 斯坦福HELM:大语言模型Holistic Evaluation整体评估框架详解
    HELM
    深入了解斯坦福推出的HELM(Holistic Evaluation of Language Models)大模型评测体系。本文解析其核心功能、安装配置步骤及应用场景,涵盖准确性、公平性、鲁棒性等多维度指标,助力开发者全面优化语言模型性能。
    1197次使用
  • MMBench详解:多模态大模型基准测试、功能特点与使用指南
    MMBench
    MMBench是由上海人工智能实验室等机构联合推出的多模态基准测试平台,提供细粒度能力评估、大规模数据集及VLMEvalKit工具。本文详细介绍其核心功能、安装使用方法及应用场景,助力开发者全面评估多模态模型性能。
    1046次使用
微信登录更方便
  • 密码登录
  • 注册账号
登录即同意 用户协议 和 隐私政策
返回登录
  • 重置密码