如何在 Go 中通过 SMTP 发送邮件并自定义发件人名称

在 go 中使用标准库 `net/smtp` 发送邮件时，`client.mail()` 仅接受纯邮箱地址作为参数，而显示给收件人的“发件人名称”需通过邮件头（`from` 字段）设置为 `"姓名 "` 格式，二者必须分离处理。

Go 的标准 net/smtp 包要求严格区分SMTP 协议层的发件人身份（用于认证与投递校验）和邮件内容层的显示发件人（用于收件人界面展示）。若将 "Sandy Sender " 直接传入 Client.Mail()，SMTP 服务器会因格式非法返回 501 5.1.7 Invalid address 错误——因为协议层只允许 RFC 5321 兼容的纯邮箱地址（如或 user@example.com），不支持带名称的 name 格式。

✅ 正确做法是 “双轨设置”：

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()。理解这一分层设计，是实现专业邮件发送的关键基础。

# word # html # go # 编码 # app # ai # 路由 # outlook # 邮箱 # 标准库 # 封装 # mail # ASCII # 邮箱地址 # 是一个 # 这一 # 推荐使用 # 不支持 # 第三方 # 设置为 # 发送邮件 # 仅用 # 只允许

返回目录在线咨询

上一篇：使用BootStrap进行轮播图的制作
下一篇：Office 365建站过程中遇到的性能优化技巧有哪些？

您的项目需求

*请认真填写需求信息，我们会在24小时内与您取得联系。

全网整合营销服务商

如何在 Go 中通过 SMTP 发送邮件并自定义发件人名称

您的项目需求