Golang发送邮件核心是用net/smtp配合mime/multipart构造MIME体,需设Content-Type、multipart/alternative结构,并用base64编码中文头字段;配置TLS加密与应用专用密码,封装为Mailer结构体提升复用性。

使用 Golang 发送邮件,核心是借助 net/smtp 包配合标准库的 mime/multipart 和 mime/quotedprintable(可选)来构造 MIME 邮件体。发送纯文本和 HTML 邮件的关键在于正确设置 Content-Type 和构造多部分(multipart/alternative)结构,让收件客户端自动选择最佳渲染方式。
配置 SMTP 连接与基础认证
大多数邮箱服务(如 Gmail、QQ 邮箱、163)要求 TLS 加密和应用专用密码(非登录密码)。需提前开启 SMTP 服务并获取授权码。
- Gmail:启用“两步验证”后生成 App Password;SMTP 地址为
smtp.gmail.com:587 - QQ 邮箱:在“账户 → POP3/IMAP/SMTP/Exchange/CardDAV/CalDAV服务”中开启 SMTP,获取授权码;地址为
smtp.qq.com:587 - 163 邮箱:开启 SMTP,授权码独立设置;地址为
smtp.163.com:25或465(SSL)
连接时推荐使用 smtp.Auth(如 smtp.PlainAuth),并显式调用 tls.Config 控制加密行为(例如跳过证书校验仅用于测试)。
构建支持文本+HTML的 multipart/alternative 邮件
要同时发送纯文本和 HTML 版本,必须将两者作为 multipart/alternative 的两个部分,按顺序排列:先 text/plain,再 text/html。邮件客户端会优先显示后者(若支持),否则回退到前者。
立即学习“go语言免费学习笔记(深入)”;
构造步骤如下:
专为中小型企业定制的网络办公软件,富有竞争力的十大特性: 1、独创 web服务器、数据库和应用程序全部自动傻瓜安装,建立企业信息中枢 只需3分钟。 2、客户机无需安装专用软件,使用浏览器即可实现全球办公。 3、集成Internet邮件管理组件,提供web方式的远程邮件服务。 4、集成语音会议组件,节省长途话费开支。 5、集成手机短信组件,重要信息可直接发送到员工手机。 6、集成网络硬
- 创建
bytes.Buffer作为邮件体容器 - 用
mime/multipart.NewWriter初始化写入器,设置根 Boundary - 调用
writer.CreatePart添加第一部分,Header 设为Content-Type: text/plain; charset=utf-8 - 写入纯文本内容(建议用
quotedprintable编码含中文的文本,避免乱码) - 再次调用
CreatePart添加第二部分,Header 设为Content-Type: text/html; charset=utf-8 - 写入 HTML 字符串(无需额外编码,UTF-8 原样写入即可)
- 调用
writer.Close()结束 multipart,自动写入尾 Boundary
组装完整邮件头并发送
邮件头(From、To、Subject、Date、MIME-Version、Content-Type)需手动拼接,并与 multipart 内容拼接成完整邮件字节流。注意:
-
Subject中文需用base64编码 +charset标明,格式如:Subject: =?utf-8?B?5byg5LiJ55WM?= -
From和To支持显示名,格式为"显示名,其中显示名同样需 base64 编码" - 完整邮件体 = 头部 + 空行 + multipart 内容
- 调用
smtp.SendMail时传入完整字节流([]byte)
示例关键 Header 构造:
From: =?utf-8?B?5rWL6K+V?=To: =?utf-8?B?5L+h5a2X?=
Subject: =?utf-8?B?5byg5LiJ55WM5ZCN?=
Date: Wed, 01 Jan 2025 12:00:00 +0800
MIME-Version: 1.0
Content-Type: multipart/alternative; boundary="boundary-string"
封装为可复用的发送函数
建议将逻辑封装为结构体(如 Mailer),预设 SMTP 主机、端口、账号、密码和 From 地址。暴露方法如:
SendText(to, subject, body string) errorSendHTML(to, subject, html string) error-
SendMixed(to, subject, text, html string) error(推荐:自动构造 alternative)
错误处理应区分网络失败、认证失败、邮箱格式错误、SMTP 拒绝等场景,便于调试。生产环境建议加入重试机制与日志记录(如使用 log/slog)。










