
在 go 中使用标准库 `net/smtp` 发送邮件时,`client.mail()` 仅接受纯邮箱地址作为参数,而显示给收件人的“发件人名称”需通过邮件头(`from` 字段)设置为 `"姓名
Go 的标准 net/smtp 包要求严格区分SMTP 协议层的发件人身份(用于认证与投递校验)和邮件内容层的显示发件人(用于收件人界面展示)。若将 "Sandy Sender
✅ 正确做法是 “双轨设置”:
- Client.Mail() 参数:仅传入纯邮箱地址(如 "user@example.com"),用于 SMTP 认证与路由;
- 邮件正文头部(Header):在构造的邮件内容中显式写入 From: Sandy Sender
行,该字段控制客户端显示效果。
以下是一个完整、可运行的标准库示例(使用 strings.Reader 构造原始邮件):
package main
import (
"fmt"
"net/smtp"
"strings"
)
func main() {
// SMTP 配置
auth := smtp.PlainAuth("", "user@example.com", "app-password", "smtp.example.com")
// 构造符合 RFC 5322 的原始邮件(注意:From 头含名称)
msg := strings.NewReader(`From: Sandy Sender
To: recipient@example.com
Subject: Hello from Go!
MIME-Version: 1.0
Content-Type: text/plain; charset="utf-8"
This is the body of the message.
`)
// 关键:Client.Mail() 只传纯邮箱地址(无名称!)
err := smtp.SendMail(
"smtp.example.com:587",
auth,
"user@example.com", // ← 必须是纯邮箱(与 From 头中的地址一致)
[]string{"recipient@example.com"},
msg,
)
if err != nil {
panic(fmt.Sprintf("failed to send email: %v", err))
}
fmt.Println("Email sent successfully!")
} ⚠️ 注意事项:
- Client.Mail() 的 from 参数与 From: 邮件头中的邮箱地址必须完全一致(忽略大小写),否则部分 SMTP 服务(如 Gmail、Outlook)会拒绝投递或标记为伪造;
- 名称部分(如 Sandy Sender)仅影响收件端显示,不参与 SMTP 认证,因此不能包含特殊字符(建议仅用 ASCII 字母、空格、连字符);
- 若需更健壮的邮件构建能力(如附件、HTML 正文、多收件人、自动 MIME 编码),推荐使用成熟第三方库,例如 gomail(v2):
m := gomail.NewMessage()
m.SetAddressHeader("From", "user@example.com", "Sandy Sender") // 自动组装为 "Sandy Sender "
m.SetAddressHeader("To", "recipient@example.com", "")
m.SetHeader("Subject", "Hello!")
m.SetBody("text/plain", "This is the body.")
// ... 发送逻辑 gomail 内部已封装上述分离逻辑,开发者无需手动拼接原始邮件,显著降低出错风险。
总结:Go 原生 SMTP 发送邮件时,“显示名称”与“协议发件人”必须解耦处理——前者写入邮件头 From 字段,后者单独传入 Client.Mail()。理解这一分层设计,是实现专业邮件发送的关键基础。










