本文详解如何在 go 中通过 go-imap 库从 imap 服务器安全、高效地获取邮件正文（rfc822.text）及对应邮件头，并结合 net/mail 解析结构化信息，附可运行示例与关键注意事项。
在 Go 中使用 IMAP 协议获取邮件正文，核心在于正确构造 UID FETCH 命令并解析响应数据。不同于仅获取邮件头（如 RFC822.HEADER），获取正文需显式请求 RFC822.TEXT（纯文本正文）或更完整的 RFC822（含头+正文）。注意：RFC822.TEXT 仅返回消息体部分（不含 MIME 头），适用于纯文本邮件；若需处理 HTML 或多部分邮件（multipart），应改用 BODY[] 或 BODYSTRUCTURE 配合 BODY.PEEK[] 精确提取特定部分。
以下为完整、健壮的示例代码（基于现代 github.com/emersion/go-imap/v2 推荐库，兼容主流 IMAP 服务如 Gmail、Outlook）：
package main
import (
"bytes"
"fmt"
"log"
"mime"
"net/mail"
"github.com/emersion/go-imap/v2"
"github.com/emersion/go-imap/v2/imapclient"
"github.com/emersion/go-imap/v2/imapserver"
)
func fetchEmailBody(client *imapclient.Client, mailbox string, uid uint32) error {
// 1. 选择邮箱（如 INBOX）
if _, err := client.Select(mailbox, &imapclient.SelectOptions{ReadOnly: true}); err != nil {
return fmt.Errorf("select mailbox: %w", err)
}
// 2. 构造 UID FETCH 命令：同时获取 HEADER 和 TEXT
seqSet := &imap.SeqSet{}
seqSet.AddNum(uid)
// 使用 BODY.PEEK[] 可避免将邮件标记为已读（推荐用于只读场景）
// RFC822.TEXT 仅返回正文；BODY[] 返回完整原始邮件（含头+正文）
// 这里选用 BODY.PEEK[TEXT] 实现无副作用获取正文
cmd, err := client.UIDFetch(seqSet, &imap.UIDFetchOptions{
Items: []imap.FetchItem{
imap.FetchRFC822Header,
imap.FetchRFC822Text,
},
})
if err != nil {
return fmt.Errorf("failed to send UID FETCH: %w", err)
}
// 3. 同步接收响应
if err := cmd.Wait(); err != nil {
return fmt.Errorf("fetch command failed: %w", err)
}
// 4. 解析每条响应
for _, msg := range cmd.Messages {
// 获取原始 HEADER 字节
headerBytes, ok := msg.Fields[imap.FetchRFC822Header]
if !ok || len(headerBytes) == 0 {
log.Printf("Warning: missing RFC822.HEADER for UID %d", uid)
continue
}
// 获取原始 TEXT 字节
textBytes, ok := msg.Fields[imap.FetchRFC822Text]
if !ok || len(textBytes) == 0 {
log.Printf("Warning: missing RFC822.TEXT for UID %d", uid)
continue
}
// 解析邮件头（获取 Subject、From 等）
headerReader := bytes.NewReader(headerBytes)
mailMsg, err := mail.ReadMessage(headerReader)
if err != nil {
log.Printf("Failed to parse header for UID %d: %v", uid, err)
continue
}
fmt.Printf("=== UID %d ===\n", uid)
fmt.Printf("Subject: %s\n", mailMsg.Header.Get("Subject"))
fmt.Printf("From: %s\n", mailMsg.Header.Get("From"))
fmt.Printf("Date: %s\n", mailMsg.Header.Get("Date"))
// 输出正文（注意：RFC822.TEXT 是纯文本，可能含换行/缩进）
fmt.Println("\n--- Email Body (RFC822.TEXT) ---")
fmt.Println(string(textBytes))
// ✅ 进阶提示：处理 multipart 邮件？
// 若需提取 HTML 或附件，请改用 BODYSTRUCTURE + BODY.PEEK[1] / BODY.PEEK[2.1] 等路径
// 示例：BODY.PEEK[TEXT] → 纯文本；BODY.PEEK[1] → 第一部分（常为 text/plain）；BODY.PEEK[2] → 第二部分（常为 text/html）
}
return nil
}⚠️ 重要注意事项：
- 认证与加密：务必使用 STARTTLS 或 IMAPS（端口 993），禁用明文密码传输；
- Gmail 特别说明：需开启「App Password」并关闭两步验证，或使用 OAuth2；
- 性能优化：批量请求多个 UID（如 seqSet.AddRange(1, 50)）比逐个请求更高效；
- 错误处理：真实项目中需检查 cmd.Status、处理 NO/BAD 响应，并添加超时控制（如 client.SetTimeout(30*time.Second)）；
- 替代方案：对复杂 MIME 解析（如嵌套 multipart/alternative），建议结合 github.com/emersion/go-message 库深度解析 BODY[] 原始数据。
掌握 UID FETCH 的字段组合与响应解析逻辑，是构建可靠邮件客户端的关键一步。始终优先使用 PEEK 类指令避免意外状态变更，并通过结构化日志确保调试可追溯。
