net/mail 可解析 RFC 5322 邮件头并读取原始正文,但不处理 multipart 结构及 Base64/Quoted-Printable 解码,需配合 mime、io 等包手动实现解码与分段解析。

go 标准库 net/mail 可以解析符合 RFC 5322 的原始邮件文本(如 .eml 文件内容或 SMTP 接收的原始报文),提取发件人、主题、日期等头部字段,以及解码后的正文。但它不负责解析 multipart 结构(如附件、html/Plain 混合体)或自动处理 Base64/Quoted-Printable 编码——这些需配合 mime 和 io 相关包手动处理。
1. 解析邮件头:获取发件人(From)、主题(Subject)等
使用 mail.ReadMessage 读取 io.Reader(比如 strings.NewReader(rawEmail)),得到一个 *mail.Message。它的 Header 是一个映射,键为标准头字段名(忽略大小写),值是字符串切片(因头字段可重复)。注意:值仍是 RFC 2047 编码的原始字节(如 =?UTF-8?B?5L2g5aW9?=),需用 mail.ParseAddress 或 mime.Decodeword 解码。
示例获取发件人:
from, err := msg.Header.Addresslist("From") if err == nil && len(from) > 0 { // 自动解码 name 和 address(支持 RFC 2047) senderName := from[0].Name // 如 "张三" senderAddr := from[0].Address // 如 "zhangsan@example.com" }
2. 提取纯文本正文:处理 Content-Type 和编码
net/mail 不解析 body,只提供 msg.Body(一个 io.Reader)。要读取正文,需结合 msg.Header.Get("Content-Type") 判断类型,并检查 "Content-Transfer-Encoding" 字段(如 base64, quoted-printable)进行解码。
立即学习“go语言免费学习笔记(深入)”;
- 若 Content-Type 是
text/plain或text/html,且无 multipart,则直接读取msg.Body并按编码解码 - 使用
mime.DecodeWord解码 header 中的字段(如 Subject) - 使用
base64.NewDecoder或quotedprintable.NewReader包装msg.Body再读取
3. 处理 multipart 邮件(含 HTML/Plain/附件)
大多数现代邮件是 multipart/alternative 或 multipart/mixed。此时 msg.Body 是原始 multipart 数据流,需用 mime.Reader(来自 net/http 或第三方库如 github.com/emersion/go-message)递归解析各部分。标准库 net/mail 本身不提供 multipart 解析能力。
简易做法(适用于简单 alternative):
- 读取整个
msg.Body到字节切片 - 用
mime.ParseMediaType解析Content-Type获取 boundary - 手动按 boundary 分割(不推荐,易出错)
- 更稳妥:用
github.com/emersion/go-message(专为邮件设计,兼容 RFC)
4. 完整小例子:解析简单 text/plain 邮件
以下代码解析一封无 multipart、Base64 编码的纯文本邮件:
import ( "bytes" "encoding/base64" "fmt" "net/mail" "strings" ) func parseSimpleMail(raw string) { r := strings.NewReader(raw) msg, _ := mail.ReadMessage(r) // 解析 From from, _ := msg.Header.AddressList("From") if len(from) > 0 { fmt.Printf("发件人: %s <%s>n", from[0].Name, from[0].Address) } // 解析 Subject(RFC 2047 解码) subject := msg.Header.Get("Subject") decoded, _ := mime.DecodeWord(subject) fmt.Printf("主题: %sn", decoded) // 解码并读取正文(假设是 base64 text/plain) encoding := strings.ToLower(msg.Header.Get("Content-Transfer-Encoding")) body := msg.Body if encoding == "base64" { body = base64.NewDecoder(base64.StdEncoding, body) } plain, _ := io.ReadAll(body) fmt.Printf("正文: %sn", strings.TrimSpace(string(plain))) }