parseaddr函数和formataddr函数的用法

　　参考：https://www.pynote.net/archives/630

　　parseaddr函数和formataddr函数，都来自email.utils模块，用来在发送Email的时候，“美化”地址中的姓名部分。本文介绍如何使用这两个函数。

　　引入parsesaddr和formataddr

　　use_parseaddr_formataddr.py

?

1 2 3

from email.header import Header from email.mime.text import MIMEText from email.utils import parseaddr,formataddr

　　由于下面代码需要使用到Header和MIMEText所以一并引入

　　带姓名的email地址

　　一般情况下，我们使用Email，地址都是直接写成这样（1）：123456@qq.com，纯Email，不带姓名。写成这样没问题，在使用工具或代码（例如MIMEText对象）编写Email内容的时候，地址都可以直接写成这样。

　　但是，这个时候，地址还有另外一种写法（2）：name<123456@qq.com>，将姓名放在Email地址前面。这种写法增加了姓名，并用尖括号将Email地址括起来，这种写法会让您发出的邮件，看起来更加专业。

　　按照第1种写法设置发件人，收到邮件时，地址显示是这样的：

 

 　　而如果采用第2种写法，收到邮件时，地址会显示成这样

　　首先看发送邮件的写法

 

 　　收件人

 

 　　这就是带姓名的Email邮件地址格式

　　注意：

?

1	有的时候，我们使用第1种Email地址发邮件，对方在邮件工具中打开时，还是能看到地址前的姓名，比如QQ信箱。这是因为你的邮件地址在对方的邮件工具里有保存，显示邮件的时候，邮件工具默认将此地址保存的姓名显示了出来。如果对方邮件工具没有保存你的邮件，就不会出现这个现象。

　　如何 parsesaddr和formataddr

　　parseaddr 函数和 formataddr 函数就是用来合成这种符合Email标准的带姓名的地址格式的。我们继续上一篇的内容，用Python发送Email的技巧，这一篇就是介绍在发送Email的时候，如何使用带姓名的Email地址格式。

?

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28

from email.header import Header from email.mime.text import MIMEText from email.utils import parseaddr,formataddr # 邮件发件人邮件格式其中pynote.net为发件人用户名可以自定义 # from@qq.com为发件人真实邮箱地址不能自定义 From = 'pynote.net<from@qq.com>' # 使用parseaddr()方法分隔用户名和邮箱地址 name,addr = parseaddr(From) print(name,addr) # pynote.net from@qq.com   # 使用formataddr方法把邮箱用户名和邮箱地址转换成标准Email地址格式 # formataddr方法接收一个元组作为参数，元组的第一个元素是经过Header编码的用户名信息 # 元组的第二个元素是邮箱地址，返回一个str # 元组的两个元素都可以为空，如果第一个元素为空则返回邮箱地址，如果第二个元素为空则返回用户名经过Header函数编码信息 # 如果两个元素都为空则返回空 fromaddr = formataddr((Header(name,'utf-8').encode(), addr)) print(fromaddr) # =?utf-8?q?pynote=2Enet?= <from@qq.com>   # 以下为收件者邮箱信息 To = 'mylove<babylove@qq.com>' name,addr = parseaddr(To) print(name,addr) # mylove babylove@qq.com toaddr = formataddr((Header(name,'utf-8').encode(), addr)) print(toaddr) # =?utf-8?q?mylove?= <babylove@qq.com>

　　注意：使用Header生成的字符串格式，如果name值有asscii字符则格式如下

?

1 2 3 4 5 6

# asscii字符 name = 'mylove' print(Header(name,'utf-8').encode()) # =?utf-8?q?mylove?= print(base64.b64encode(name.encode('utf-8'))) # b'bXlsb3Zl'

　　格式解析如下

?

1 2 3 4 5 6

=?utf-8?q?mylove?= =? #为固定格式开头 utf-8?#为utf-8编码 q? #只有ascii码不包含中文 mylove #为原文 ?= #为固定结尾

　　

　　如果name包含中文则格式如下

?

1 2 3 4 5 6

# 包含中文 name = '中文' print(Header(name,'utf-8').encode()) # =?utf-8?b?5Lit5paH?= print(base64.b64encode(name.encode('utf-8'))) # b'5Lit5paH'

　　如果name包含中文则生成的字符串中包含使用base64解码的字符串，前面使用b?而不是q?

 

　　将带姓名的Email格式作为参数，给parseaddr函数，得到name和addr。name就是姓名，addr就是纯Email，请看parseaddr解析To后的打印显示。然后formataddr函数再将name和addr转换成标准Email地址格式。注意name还要经过Header函数的编码。fromaddr和toaddr，就是最后我们可以使用的地址字符串。我们来使用一下：

?

1 2 3 4 5 6 7 8 9 10 11

# 定义发送邮件的邮件内容信息 msg_str = 'this is a name-based email address test' # 注意到构造MIMEText对象时 # 第一个参数就是邮件正文 # 第二个参数是MIME的subtype，传入'plain'表示纯文本，最终的MIME就是'text/plain' # 最后一定要用utf-8编码保证多语言兼容性 msg = MIMEText(msg_str,'plain','utf-8') msg['From'] = fromaddr msg['To'] = toaddr # 把MIMEText对象转换成str print(msg.as_string())

 

 　　msg['From']和msg['To']直接使用formataddr后的字符串，如果有多个这样的字符串地址，用逗号（,）分开。但是sendmail函数不使用编码后的带姓名的Email地址字符串，还是使用纯Email地址，这个细节要注意。带姓名的Email地址的编码，只是改变邮件内容的头部，而不改变投递细节。

　　小工具

　　这个函数小工具，合并了 parseaddr和formataddr功能，输入 以第2种方式编写的Email地址，得到直接可以在MIMEText中使用字符串，请收藏：

?

1 2 3

def _format_addr(s):     name, addr = parseaddr(s)     return formataddr((Header(name,'utf-8').encode(), addr))

　　这个函数即把以第2中方式写入的Email地址，返回为可以在MIMEText中使用字符串

　　这个函数还自带了一定能的容错性：

?

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16

# 容错性 # 标准格式 print(_format_addr('godaddy<1123456@hotmail.com>')) # =?utf-8?q?godaddy?= <1123456@hotmail.com> # 没有用户名只有email地址地址没有使用<>括起来 print(_format_addr('1123456@hotmail.com')) # 1123456@hotmail.com # 没有用户名 print(_format_addr('<1123456@hotmail.com>')) # 1123456@hotmail.com print(_format_addr('pythonisgood<1123456@hotmail.com>')) # =?utf-8?q?pythonisgood?= <1123456@hotmail.com> print(_format_addr('pythonisgood')) # 用户名和地址都为空返回也为空字符串 print(_format_addr('')) #

　　parseaddr和formataddr函数的使用并不难，关键是要里面Email的地址格式，本文就介绍这么多啦。