本文详解 go 标准库 smtp.sendmail 如何正确支持多个收件人，指出常见数组格式错误、smtp 协议限制及邮件头构造要点，并提供标准库与 gomail 库两种生产级实现方案。
本文详解 go 标准库 smtp.sendmail 如何正确支持多个收件人，指出常见数组格式错误、smtp 协议限制及邮件头构造要点，并提供标准库与 gomail 库两种生产级实现方案。
在 Go 中调用 net/smtp.SendMail 发送多收件人邮件时，一个典型误区是将多个邮箱地址拼接成单个字符串并放入切片中（如 []string{"a@example.com, b@example.com"}），这会导致 SMTP 服务器返回 501 Syntax error in arguments 错误——因为 SendMail 的第四个参数 to []string 要求每个元素必须是独立、合法的邮箱地址，而非逗号分隔的字符串。
✅ 正确写法：每个收件人地址单独作为切片的一个元素：
to := []string{
"alice@yahoo.com",
"bob@gmail.com",
"charlie@outlook.com",
}
err := smtp.SendMail(
"smtp.mail.yahoo.com:587", // 建议使用 587（STARTTLS）而非已弃用的 25 端口
auth,
"sender@yahoo.com", // from 地址（必须与认证账号一致）
to, // ✅ 切片内各元素为独立邮箱
[]byte(msg), // 构造完整的 RFC 5322 邮件正文（含 From/To/Subject 等头）
)⚠️ 关键注意事项：
- to 参数仅用于 SMTP RCPT TO 命令：它控制邮件实际投递的目标地址（即 SMTP 层收件人），不决定邮件头中的 To: 字段显示内容。后者需手动写入 msg 字节流中。
-
邮件头 To: 必须显式构造：SendMail 不自动解析或填充邮件头。若希望收件人在客户端看到多个收件人，需在 []byte(msg) 中完整写出符合 RFC 规范的头部，例如：
msg := []byte(`To: Alice <alice@yahoo.com>, Bob <bob@gmail.com> From: "Test Sender" <sender@yahoo.com> Subject: Hello from Go MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8"
This is a test email sent to multiple recipients.`)
- **Yahoo SMTP 要求严格认证与端口**：务必使用 `auth = smtp.PlainAuth("", "sender@yahoo.com", "app-password", "smtp.mail.yahoo.com")`，且推荐端口 `587` + STARTTLS（需用 `gomail` 或自行封装 TLS）；纯 `:25` 易被拒绝或限流。
- **避免邮箱地址格式错误**：确保所有地址为标准 `local@domain.tld` 格式，无空格、换行或 HTML 实体（如原始问题中混淆的 `<a>` 标签和 `data-cfemail` 加密内容需解密还原为真实邮箱）。
? 更推荐方案：使用 `gomail`（现代、健壮、易维护）
标准库 `smtp.SendMail` 功能简陋，缺乏 MIME 构建、附件、HTML 支持及自动 TLS 协商。生产环境强烈建议使用社区成熟库 `gomail`（v2）：
```go
package main
import (
"log"
"gopkg.in/gomail.v2"
)
func main() {
m := gomail.NewMessage()
m.SetAddressHeader("From", "sender@yahoo.com", "Test Sender")
m.SetHeader("To",
m.FormatAddress("alice@yahoo.com", "Alice"),
m.FormatAddress("bob@gmail.com", "Bob"),
)
m.SetHeader("Subject", "Hello from Go (Multiple Recipients)")
m.SetBody("text/plain", "This email was sent to both Alice and Bob.")
// 自动协商 STARTTLS，支持 Yahoo / Gmail / Outlook 等主流服务商
d := gomail.NewDialer("smtp.mail.yahoo.com", 587, "sender@yahoo.com", "your-app-password")
if err := d.DialAndSend(m); err != nil {
log.Fatal("Failed to send email:", err)
}
log.Println("Email sent successfully!")
}? 总结：
- smtp.SendMail 的 to []string 是 SMTP 协议层面的收件人列表，必须为纯净邮箱字符串切片；
- 邮件头 To: 需手动构造，二者需逻辑一致；
- 直接使用标准库易出错，gomail 提供类型安全、自动编码、TLS 封装和清晰 API，应作为默认选择；
- 始终使用应用专用密码（App Password）替代账户密码，并启用两步验证（Yahoo/Gmail 均强制要求）。
