本文详解如何用 gomail.v2 正确实现单封邮件群发（多个收件人可见），避免常见误区——如手动拼接字符串导致仅首地址接收、或循环发送导致收件人不可见，涵盖 setheader("to", ...) 的可变参数用法、地址格式化、以及与 smtp 协议语义的一致性。
本文详解如何用 gomail.v2 正确实现单封邮件群发（多个收件人可见），避免常见误区——如手动拼接字符串导致仅首地址接收、或循环发送导致收件人不可见，涵盖 setheader("to", ...) 的可变参数用法、地址格式化、以及与 smtp 协议语义的一致性。
在 Go 生态中，gomail.v2 是发送多收件人邮件最可靠、最符合 RFC 规范的高层封装库。许多开发者误以为“群发 = 循环调用 DialAndSend”，但这会导致每封邮件仅含一个收件人（To 字段单一），且无法在客户端显示全部收件人；另一常见错误是将多个邮箱拼成逗号分隔的字符串（如 "a@x.com,b@y.com"）传给 SetHeader("To", ...)，这虽能渲染显示，但 SMTP 层实际只向首个地址投递——其余地址被忽略，违反协议语义。
✅ 正确做法是：让 gomail 同时向多个收件人投递（SMTP RCPT TO 多次），并在邮件头中显式声明所有收件人（To: 头字段）。gomail.v2 原生支持这一模式，关键在于正确使用 SetHeader 的可变参数语法和地址标准化。
✅ 标准写法：批量设置 To 收件人
recipients := os.Args[3:] // 例如: []string{"alice@example.com", "bob@test.org", "charlie@domain.com"}
// 方式一：直接展开切片（推荐，简洁清晰）
mail.SetHeader("To", recipients...)
// 方式二：使用 mail.FormatAddress 统一格式化（支持昵称）
addresses := make([]string, len(recipients))
for i, r := range recipients {
addresses[i] = mail.FormatAddress(r, "") // 第二个参数为昵称，留空则仅邮箱
}
mail.SetHeader("To", addresses...)
⚠️ 注意：SetHeader("To", ...) 接收的是 ...string，即每个收件人必须作为独立参数传入。recipients... 将切片解包为多个字符串参数，等价于 SetHeader("To", "a@x.com", "b@y.com", "c@z.com") —— 这正是 gomail 构造合法 To: 头和底层 RCPT TO 命令所依赖的语义。
? 底层机制说明
- gomail.DialAndSend() 内部会遍历 To、Cc、Bcc 头中所有地址，对每个地址执行一次 RCPT TO SMTP 命令；
- 同时，它会将这些地址按 RFC 5322 规范格式化后写入邮件头的 To: 字段（如 To: alice@example.com, bob@test.org）；
- 因此，收件人在 Gmail、Outlook 等客户端中既能收到邮件，也能看到其他收件人列表（除非使用 Bcc）。
❌ 常见错误对比
| 错误方式 | 问题 |
|---|---|
| mail.SetHeader("To", "a@x.com,b@y.com") | SMTP 仅向 a@x.com 投递；b@y.com 不在 RCPT TO 列表中，邮件头虽显示但不送达 |
| for _, r := range recps { mail.SetHeader("To", r); dialer.DialAndSend(mail) } | 每封邮件只有一个收件人；无法实现“同封邮件多人可见”的群发效果 |
| mail.SetHeader("To", strings.Join(recps, ",")) | 同第一种，本质仍是单字符串，gomail 不解析逗号分隔 |
✅ 完整可运行示例
package main
import (
"log"
"os"
"gopkg.in/gomail.v2"
)
func main() {
if len(os.Args) <subject><recipient1> [recipient2] [...]")
}
// 构建邮件
m := gomail.NewMessage()
m.SetAddressHeader("From", "sender@example.com", "My App")
m.SetHeader("Subject", os.Args[2])
m.SetBody("text/html", os.Args[1])
// ✅ 正确添加多个收件人（To 字段 + RCPT TO 均生效）
recipients := os.Args[3:]
m.SetHeader("To", recipients...)
// 配置 SMTP（以 126 邮箱为例，端口 465 + TLS）
d := gomail.NewDialer("smtp.126.com", 465, "sender@126.com", "your-app-password")
// 发送（单次调用，群发完成）
if err := d.DialAndSend(m); err != nil {
log.Fatalf("Failed to send email: %v", err)
}
log.Printf("Email sent successfully to %d recipients.", len(recipients))
}</recipient1></subject>
? 补充注意事项
- 认证与端口匹配：Gmail 推荐 smtp.gmail.com:587 + STARTTLS；163/126/QQ 邮箱常用 smtp.xxx.com:465 + TLS（需确保 gomail.NewDialer 自动启用 TLS，或手动配置 Dialer.TLSConfig）；
- 中文/特殊字符：SetHeader("Subject", ...) 和 SetBody(...) 中的中文无需手动 Base64 编码，gomail 会自动处理 MIME 编码；
- Bcc 支持：若需隐藏部分收件人，使用 m.SetHeader("Bcc", bccRecipients...)，它们参与 RCPT TO 但不出现在 To: 或 Cc: 头中；
- 错误处理：DialAndSend 若失败，通常返回具体 SMTP 错误码（如 535 Authentication failed），建议结合日志与重试策略。
综上，gomail.v2 的 SetHeader("To", ...) 是实现合规、高效、可见的多收件人邮件的唯一推荐路径——既符合 SMTP 协议设计，又免去手动构造 MIME 头的复杂性，是生产环境的最佳实践。
