Go net/mail 怎样解析带显示名的地址

从邮件头读取 张三 时，不要用字符串切片或正则表达式硬拆。Go 标准库 net/mail 已经把结果拆成 Name 和 Address 两个字段：单个地址用 mail.ParseAddress，逗号分隔的多个地址用 mail.ParseAddressList；如果显示名是 RFC 2047 编码词，再使用带 WordDecoder 的 mail.AddressParser。

Go net/mail 的解析结果先分成 Name 与 Address

mail.Address 的模型很直接：Name 允许为空，Address 保存 user@domain。例如输入 Alice ，解析后不要再从原字符串中截取尖括号，直接使用结构体字段即可。

Go net/mail 怎样解析一个带显示名的地址

最小写法只需要检查错误，再读取两个字段。下面的示例把“显示名为空”保留为合法结果，把邮箱格式解析失败当作输入错误交给调用方处理。

package main

import (
    "fmt"
    "log"
    "net/mail"
)

func main() {
    raw := "张三 "

    // ParseAddress 负责识别 name-addr，不要用字符串切片拆尖括号。
    addr, err := mail.ParseAddress(raw)
    if err != nil {
        log.Fatalf("解析邮件地址失败: %v", err)
    }

    // Name 可为空；Address 是后续去重、入库或投递配置要使用的字段。
    fmt.Printf("显示名=%q，邮箱=%q\n", addr.Name, addr.Address)
}

这里的“解析成功”只说明字符串符合 net/mail 的解析范围。应用仍然可以继续做域名白名单、业务收件人数量限制或投递服务商校验。

带编码显示名时用 AddressParser 解码

有些邮件头不是直接写中文，而是使用 RFC 2047 encoded-word，例如 =?UTF-8?B?5byg5LiJ?= 。这类输入建议显式创建 mail.AddressParser，把解码职责交给 mime.WordDecoder。

package main

import (
    "fmt"
    "log"
    "mime"
    "net/mail"
)

func main() {
    raw := "=?UTF-8?B?5byg5LiJ?= "
    parser := &mail.AddressParser{
        // WordDecoder 让 RFC 2047 的 UTF-8 显示名还原为可读文本。
        WordDecoder: new(mime.WordDecoder),
    }

    addr, err := parser.Parse(raw)
    if err != nil {
        log.Fatalf("解析编码地址失败: %v", err)
    }

    // 邮箱地址本身仍单独保存在 Address 字段中。
    fmt.Printf("显示名=%q，邮箱=%q\n", addr.Name, addr.Address)
}

如果系统接收到其他字符集的 encoded-word，应按实际字符集提供 CharsetReader，不要把所有解码失败都当成邮箱地址错误。显示名用于展示，业务主键通常仍应围绕规范化后的邮箱地址设计。

单地址、地址列表和异常输入的边界

当邮件头可能出现多个收件人时，使用 ParseAddressList。它会按邮件地址语法处理列表，能避开简单逗号切分在引号显示名中的边界问题。

package main

import (
    "fmt"
    "log"
    "net/mail"
)

func main() {
    raw := `Alice , "研发, 值班" `

    // ParseAddressList 处理完整地址列表；不要先 strings.Split(raw, ",")。
    list, err := mail.ParseAddressList(raw)
    if err != nil {
        log.Fatalf("解析地址列表失败: %v", err)
    }

    for _, addr := range list {
        // 每个元素都要独立检查 Name 和 Address 的业务使用规则。
        fmt.Printf("%s \n", addr.Name, addr.Address)
    }
}

工程上建议把错误分为三层：语法解析错误直接拒绝或记录原文；解析成功但 Address 不在允许域名内时进入业务校验；通过业务校验后再交给 SMTP 或邮件服务商。net/mail 不负责 DNS、投递和地址存在性验证。

常见问题

没有显示名时 Name 会是什么？

通常为空字符串，例如输入 alice@example.com。展示层可以回退到邮箱地址，但不要把回退值写回原始邮件头。

能不能用正则表达式替代 net/mail？

不建议。正则很容易漏掉引号、编码词和列表边界；标准库解析后仍应补充自己的业务规则。

ParseAddress 成功就代表地址有效吗？

不是。它只完成语法层解析，域名解析、邮箱存在性、退信风险和发送权限需要由后续系统判断。

选择规则可以压缩成一句话：单地址先用 ParseAddress，列表用 ParseAddressList，看到 RFC 2047 编码显示名就换成配置了 WordDecoder 的 AddressParser，然后把语法结果与投递校验分开。