讲师中心 微信公众号

工具推荐

视频效率加速
updream

一键生成高质量推广成片

Laper
Laper

剧本策划到成片协作

Seko
Seko

AI短剧一键生成成片

立刻MV
立刻MV

低成本歌曲 MV、视频生成

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

冬晨吖_6697

冬晨吖_6697

发布时间:2025-12-29 18:03:58

|

303人浏览过

|

来源于php中文网

原创

如何在 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 构造原始邮件):

Word 文档生成与编辑
Word 文档生成与编辑

需要创建、读取、编辑或处理 Word 文档(.docx / .dotx)时使用。触发词:'Word'、'word 文档'、'.docx'、'生成报告'、'制作合同/简历/方案/说明书'、'提取 word 内容'、'在文档里查找替换'、'给文档加页眉页脚/目录/表格'。也用于把任意内容排版成一份正式的 Word 文件。不要用它处理 PDF、Excel 或无关编程任务。中文创作场景尤其适合:小说大纲稿、投稿文档、合同、简历、工作总结。

下载
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 <user@example.com>
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 <user@example.com>"
m.SetAddressHeader("To", "recipient@example.com", "")
m.SetHeader("Subject", "Hello!")
m.SetBody("text/plain", "This is the body.")
// ... 发送逻辑

gomail 内部已封装上述分离逻辑,开发者无需手动拼接原始邮件,显著降低出错风险。

总结:Go 原生 SMTP 发送邮件时,“显示名称”与“协议发件人”必须解耦处理——前者写入邮件头 From 字段,后者单独传入 Client.Mail()。理解这一分层设计,是实现专业邮件发送的关键基础。

热门AI工具

更多
码上飞
码上飞 Hot

一款基于自然语言的AI应用开发平台,可根据用户描述自动生成应用程序,帮助个人和团队快速完成应用原型与开发。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

函子Zion

一款支持AI搭建、可视化编辑和多端发布的全栈无代码开发平台。

PixTV
PixTV Hot

PixTV是一款面向AIGC内容创作的AI视频生成工具。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

相关专题

更多
常见的编码方式
常见的编码方式

常见的编码方式有ASCII编码、Unicode编码、UTF-8编码、UTF-16编码、GBK编码等。想了解更多编码方式相关内容,可以阅读本专题下面的文章。

1528

2023.10.24

a和A对应的ASCII码数值
a和A对应的ASCII码数值

a的ascii码是65,a的ascii码是97;ascii码表中,一个字母的大小写数值相差32,一般知道大写字母的ascii码数值,其对应的小写字母的ascii码数值就算出来了,是大写字母的ascii码数值“+32”。想了解更多相关的内容,可阅读本专题下面的相关文章。

5707

2024.10.24

Postman身份认证怎么配置
Postman身份认证怎么配置

本专题从实际API接口调试场景出发,讲解Postman身份认证的完整配置流程,包括常见认证协议介绍、授权参数设置、访问令牌填写、OAuth 2.0授权及认证失败排查,帮助用户正确完成接口授权与访问验证。

80

2026.11.06

Postman请求头Headers怎么设置
Postman请求头Headers怎么设置

围绕Postman HTTP请求头配置展开,讲解Headers选项的具体使用方式,包括Key和Value参数填写、请求头信息添加、常见Header字段设置及请求头修改方法,帮助用户解决接口调试过程中遇到的请求头配置问题。

40

2026.11.06

Postman接口请求发送教程
Postman接口请求发送教程

详细介绍Postman接口请求的创建与发送方法,涵盖GET和POST请求、URL配置、请求参数、Headers请求头、Body请求体设置以及响应结果查看,帮助用户掌握Postman接口请求的完整操作流程。

80

2026.11.06

DBeaver怎么导入数据
DBeaver怎么导入数据

DBeaver数据导入专题,整理Excel、CSV、SQL、TXT等常见文件的数据导入方法,涵盖目标数据库选择、数据表创建、字段映射、数据类型设置及导入参数配置等操作,帮助用户将本地文件中的数据写入数据库,并了解批量导入、重复数据处理和导入失败等常见问题的解决方法。

60

2026.11.05

DBeaver安全防护教程大全
DBeaver安全防护教程大全

DBeaver安全防护专题,围绕数据库连接安全、账号密码保护和访问权限管理展开,整理SSL/TLS加密连接、SSH隧道、数据库凭据保存及证书验证等配置方法,同时介绍敏感信息保护、远程连接风险和高权限账号使用等注意事项,帮助用户提高数据库日常管理的安全性。

60

2026.11.05

DBeaver连接创建与配置教程
DBeaver连接创建与配置教程

本专题聚焦DBeaver数据库连接配置与管理,覆盖从新建连接、选择数据库类型到填写连接参数和验证连接的完整流程。针对MySQL、PostgreSQL、SQL Server等常见数据库,整理相应的连接设置方法,并提供驱动缺失、认证失败和连接异常等问题的排查方向。

60

2026.11.04

XORM框架结构体映射与表结构同步
XORM框架结构体映射与表结构同步

本专题围绕XORM框架的结构体映射展开,说明表名与字段的命名策略、xorm标签常用属性、主键自增与时间字段自动填充,并演示Sync2自动建表、增量字段升级、索引声明与反向生成结构体的完整流程。

60

2026.11.04

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
GDB 17.2 官方文档集合
GDB 17.2 官方文档集合

共0课时 | 0人学习

Bootstrap 入门安装配置
Bootstrap 入门安装配置

共0课时 | 0人学习

38+ PhpStorm 提示和技巧
38+ PhpStorm 提示和技巧

共1课时 | 239人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn