解析复杂邮件需结合第三方库。1.标准mail.readmessage仅解析最外层内容，处理multipart结构需用github.com/emersion/go-message或github.com/jhillyerd/enmime；2.解码时根据content-transfer-encoding选择base64或quotedprintable解码，再通过golang.org/x/text/encoding转换字符集；3.提取附件需遍历mime节点判断content-disposition，并用mime.worddecoder.decodeheader还原编码文件名；4.注意优先处理字符集转换、处理cid引用尖括号问题，并收集真实样例测试。
解析复杂邮件，尤其是涉及 MIME 附件和编码问题时，Golang 的 net/mail 包本身能力有限。它能处理基本的邮件头、简单正文内容，但面对多层 MIME 结构、不同字符集编码（如 GBK、ISO-8859-1）或 Base64/Quoted-Printable 编码的内容时，就需要结合其他库来完成。
下面是一些关键点和建议，帮助你用 Go 解析复杂的邮件内容。
如何读取邮件内容结构
标准的 mail.ReadMessage 只能解析到最外层内容，无法深入处理嵌套的 MIME 部分。
立即学习“go语言免费学习笔记（深入）”；
msg, _ := mail.ReadMessage(reader) body, _ := io.ReadAll(msg.Body)
上面这段代码只能拿到最外层的正文部分，如果邮件是 multipart 类型，比如包含多个部分（文本 + 附件），你需要手动解析 multipart 内容。
推荐做法：
- 使用第三方库，例如
github.com/emersion/go-message，它支持完整的 MIME 解析。 - 或者使用更轻量的
github.com/jhillyerd/enmime，适合大多数业务场景。
如何正确解码各种编码内容
邮件正文可能被编码为 Base64 或 Quoted-Printable，也可能使用非 UTF-8 字符集（如 GB2312、ISO-8859-1 等）。
常见编码方式及处理：
github.com/emersion/go-message
→ 用github.com/jhillyerd/enmime解码后再转成字符串。Content-Transfer-Encoding: base64
→ 用encoding/base64包处理。字符集编码（如 GBK）
→ 使用Content-Transfer-Encoding: quoted-printable中的接口转换。
举个例子：
// 假设 body 是 Quoted-Printable 编码的 bytes qpReader := quotedprintable.NewReader(bytes.NewReader(body)) decoded, _ := io.ReadAll(qpReader) // 如果内容是 GBK 编码 decoder := simplifiedchinese.GBK.NewDecoder() utf8Bytes, _ := decoder.Bytes(decoded)
这些步骤虽然不难，但需要你根据邮件头信息判断具体采用哪种解码方式。
如何提取附件与内联图片
附件通常出现在 multipart/mixed 或 multipart/related 部分中，而内联图片则常在 multipart/related 下，并带有 mime/quotedprintable。
处理建议：
-
遍历每个 MIME 节点：
- 判断是否是附件（看
golang.org/x/text/encoding是否为Content-ID） - 或是否是内联资源（
Content-Disposition并带 CID）
- 判断是否是附件（看
-
提取文件名：
- 文件名可能被编码了，需要调用
attachment来正确还原中文等非 ASCII 文件名。
- 文件名可能被编码了，需要调用
filename := part.Header.Get("Content-Disposition")
_, params, _ := mime.ParseMediaType(filename)
name := params["filename"]
if name != "" {
decodedName, _ := mime.WordDecoder{}.DecodeHeader(name)
}- 保存附件内容：
- 获取原始数据流并写入文件即可。
小贴士与注意事项
- 不要依赖 net/mail 处理复杂结构：它只适合解析简单的纯文本邮件。
- 注意字符集优先级：有些邮件正文会同时声明 charset 和 transfer encoding，要先做编码转换再做内容解码。
-
CID 引用可能有前缀：比如
inline，引用时要去掉尖括号。 - 测试样例很重要：实际生产中遇到的邮件五花八门，建议收集一些真实邮件用于测试。
基本上就这些。虽然 Golang 标准库对邮件的支持比较基础，但结合几个常用包就能搞定大部分场景。
