go 的 net/mail 包仅按 rfc 5322 结构化解析邮件地址,不验证格式、不处理 idn 或 mime 编码;需用 mail.parseaddress(单个)或 parseaddresslist(批量)并严格检查 error;address 字段需手动拆分本地部分和域名,且不校验有效性。

Go 的 net/mail 包能解析邮件地址,但不验证格式合法性,也不处理常见别名或国际化域名(IDN);它只按 RFC 5322 做结构化解析,且对 malformed 输入容易 panic。
解析单个邮箱字符串:用 mail.ParseAddress 而非正则
直接调用 mail.ParseAddress 是最稳妥的方式——它内部处理了引号、转义、空格、注释等 RFC 允许的复杂情况,而正则几乎无法覆盖全。注意它返回的是 *mail.Address,包含 Name 和 Address 字段(后者是纯邮箱,不含姓名)。
常见错误现象:ParseAddress 遇到未闭合引号或非法转义会返回 error,不是 nil;若忽略 error 直接解引用指针,运行时 panic。
- 输入
"John Doe" <john></john>→ 正确解析出 Name="John Doe", Address="john@example.com" - 输入
user@domain(无尖括号)→ Address="user@domain", Name="" - 输入
foo@bar..com→ 解析成功(net/mail不校验域名有效性),Address="foo@bar..com" - 必须检查 error:
addr, err := mail.ParseAddress(s); if err != nil { /* 处理 */ }
批量解析地址列表:用 mail.ParseAddressList 拆分逗号分隔串
适用于 HTTP Header(如 From、To、Cc)中常见的多地址字段。它按逗号分割,但会跳过引号内、括号内、转义后的逗号,比 strings.Split 安全得多。
立即学习“go语言免费学习笔记(深入)”;
使用场景:解析 mail.Header.Get("To") 返回的原始字符串。
- 输入
"A" <a>, <b>, "C, D" <c></c></b></a>→ 得到 3 个*mail.Address - 输入含中文姓名如
张三 <zs></zs>→ Name 字段为 UTF-8 字节序列,需自行处理显示(net/mail不做编码转换) - 若某项解析失败,整个列表解析失败,不会部分成功;错误信息不指出具体哪一项错
- 不自动 trim 空格,但解析时已忽略前后空白;中间多余空格保留在
Name中
提取邮箱本地部分和域名:手动拆分 Address 字段
mail.Address.Address 是完整邮箱字符串(如 user+tag@domain.com),net/mail 不提供进一步拆解函数。必须自己用 strings.LastIndex 找 @,再切分。
为什么这样做:RFC 允许本地部分含点、加号、百分号等(如 a.b+c@d.com),但域名部分必须符合 DNS 规则——而 net/mail 不做任何验证,连 @ 是否唯一都不检查。
- 错误示例:
addr.Address = "a@b@c.com"→strings.LastIndex(addr.Address, "@")返回第二个@位置,结果错误 - 正确做法:
at := strings.LastIndex(addr.Address, "@"); if at == -1 { /* 无效 */ } else { local := addr.Address[:at]; domain := addr.Address[at+1:] } - 注意:国际化域名(如
用户@例子.中国)会被解析为 Punycode 形式(用户@xn--fsq097z.xn--fiqs8s),net/mail不处理 IDN 编解码 - 本地部分含引号(
"foo bar"@d.com)时,Address字段已去引号,无需额外处理
绕过解析直接提取邮箱:用正则仅作粗筛时的底线写法
如果只是日志清洗、前端简单校验等弱场景,且确定输入可控,可用正则快速提取疑似邮箱。但绝不能替代 ParseAddress 做正式解析。
性能影响:正则比 ParseAddress 快数倍,但匹配精度差;net/mail 解析是纯内存操作,无 I/O,开销可忽略。
- 底线正则:
[a-zA-Z0-9._%+\-]+@[a-zA-Z0-9.\-]+\.[a-zA-Z]{2,}—— 覆盖 95% 常见格式,但漏掉引号姓名、允许..域名 - 不要用网上“完美 RFC 正则”,它长达上千字符、极难维护、性能差,且 Go 的
regexp不支持所有 PCRE 特性 - 若必须验证域名有效性,用
net.ParseIP(domain)判断是否为 IP,再用第三方库(如github.com/miekg/dns)查 MX 记录——net/mail完全不碰网络
真正麻烦的是混合编码(比如 ISO-8859-1 的 Name 出现在 UTF-8 主体中),net/mail 不做 MIME 解码;遇到 =?UTF-8?B?... 这类编码,得先用 mime.DecodeWord 预处理字符串,再喂给 ParseAddress。










