在 go 中使用标准库 `net/smtp` 发送邮件时，仅靠 `client.mail()` 传入带名称的邮箱会导致 501 错误；正确做法是将“显示名称 + 邮箱”格式写入邮件正文头部的 `from` 字段，而 `client.mail()` 参数必须为纯邮箱地址。
Go 标准库 net/smtp 的 Client.Mail(from string) 方法仅接受 RFC 5321 兼容的纯邮箱地址（如 <a class="__cf_email__" data-cfemail="e99aa8a3a9a8bfa9a4bdb1aca0a9e7aaa6a4" href="/cdn-cgi/l/email-protection">[email protected]</a>），不支持 "Name <email>" 这类带显示名的格式——否则 SMTP 服务器会拒绝并返回 501 5.1.7 Invalid address。
真正控制收件端显示名称的，是邮件内容头部（MIME header）中的 From: 字段。该字段遵循 RFC 5322，允许使用带引号的显示名语法：
From: Sandy Sender <<a class="__cf_email__" data-cfemail="b7c4d2d9d3d2c5f7d2cfc6cad7cbe289c4c8ca" href="/cdn-cgi/l/email-protection">[email protected]</a>>
✅ 正确实现步骤如下：
- Client.Mail() 传纯邮箱地址（用于 SMTP 协议层身份验证与投递路由）；
- 在构造邮件正文时，在头部显式设置 From: 行，格式为 "显示名 <邮箱>"；
- 确保整个邮件符合 MIME 格式（含空行分隔头与体、正确编码等）。
✅ 手动构造示例（标准库）
package main
import (
"fmt"
"net/smtp"
"strings"
)
func main() {
auth := smtp.PlainAuth("", "user@example.com", "app-password", "smtp.example.com")
to := []string{"<a class="__cf_email__" data-cfemail="166473757f667f73786256736e777b667a733875797b" href="/cdn-cgi/l/email-protection">[email protected]</a>"}
from := "<a class="__cf_email__" data-cfemail="5a293f343e3f281a3f223b372a363f74393537" href="/cdn-cgi/l/email-protection">[email protected]</a>" // ← 仅邮箱！用于 Mail()
fromHeader := "Sandy Sender <" + from + ">" // ← 带名格式！用于 From: 头部
msg := fmt.Sprintf(
"From: %s\r\n"+
"To: %s\r\n"+
"Subject: Hello from Go!\r\n"+
"MIME-Version: 1.0\r\n"+
"Content-Type: text/plain; charset=utf-8\r\n"+
"\r\n"+
"This is the body of the message.",
fromHeader, strings.Join(to, ", "),
)
err := smtp.SendMail(
"smtp.example.com:587",
auth,
from, // ← 关键：纯邮箱
to,
[]byte(msg),
)
if err != nil {
panic(err)
}
}✅ 推荐方案：使用 gomail（更安全、更简洁）
手动拼接邮件头易出错（如编码缺失、换行符不规范）。推荐使用成熟封装库 gomail（v2），它自动处理 RFC 合规性、UTF-8 编码、MIME 分隔等细节：
package main
import (
"gopkg.in/gomail.v2"
)
func main() {
m := gomail.NewMessage()
m.SetAddressHeader("From", "<a class="__cf_email__" data-cfemail="4e3d2b202a2b3c0e2b362f233e222b602d2123" href="/cdn-cgi/l/email-protection">[email protected]</a>", "Sandy Sender")
m.SetAddressHeader("To", "<a class="__cf_email__" data-cfemail="c5b7a0a2a8b1a8a4afb581a4b9a0acb1adb4fba6aaa8" href="/cdn-cgi/l/email-protection">[email protected]</a>")
m.SetHeader("Subject", "Hello!")
m.SetBody("text/plain", "This is the body of the message.")
d := gomail.NewPlainDialer("smtp.example.com", 587, "user@example.com", "app-password")
if err := d.DialAndSend(m); err != nil {
panic(err)
}
}⚠️ 注意事项： 显示名（如 "Sandy Sender"）若含非 ASCII 字符（如中文），gomail 会自动进行 B 类型 MIME 编码（如 =?UTF-8?B?5byg5LiJ?=），而手动拼接需自行调用 mime.BEncoding.Encode()； SMTP 认证凭据建议使用应用专用密码（如 Gmail App Password），避免主密码泄露； 生产环境务必启用 TLS（gomail.NewDialer 支持 TLSConfig），禁用明文传输。
通过分离「协议层发件地址」与「展示层发件人信息」，即可优雅实现专业邮件署名效果。
