17370845950

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。邮件客户端会优先显示后者（若支持），否则回退到前者。

构造步骤如下：

• 创建 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) error
• SendHTML(to, subject, html string) error
• SendMixed(to, subject, text, html string) error（推荐：自动构造 alternative）

错误处理应区分网络失败、认证失败、邮箱格式错误、SMTP 拒绝等场景，便于调试。生产环境建议加入重试机制与日志记录（如使用 log/slog）。