最简可行路径是四步：构造带Base64编码中文Subject的邮件头、组装MIME内容、建立带认证的SMTP连接、调用client.SendMail；须严格匹配服务商配置，预检端口连通性，避免乱码与认证失败。
用 net/smtp 发送纯文本邮件最简可行路径
Go 标准库的 net/smtp 足够完成基础邮件发送，无需第三方包。关键不是“能不能发”，而是怎么避开认证失败、连接超时、编码乱码这三类高频问题。
核心步骤就四步：构造邮件头 + 组装 MIME 内容 + 建立带认证的 SMTP 连接 + 调用 client.SendMail。注意：SMTP 服务器地址、端口、账号密码必须严格匹配服务商要求（比如 Gmail 必须开“应用专用密码”，QQ 邮箱需开启 SMTP 并用授权码）。
- 邮件正文必须手动拼接
To、From、Subject和MIME-Version等头字段，不能只写正文内容 -
Subject含中文时，必须用=?UTF-8?B?...Base64 编码，否则收件端显示乱码 - 连接前建议先用
net.DialTimeout测试端口连通性，避免SendMail报错时无法区分是网络问题还是认证问题
package main
import (
"fmt"
"net/smtp"
"time"
)
func sendPlainTextEmail() error {
from := "user@example.com"
password := "your_app_password" // 不是登录密码
to := []string{"receiver@example.com"}
smtpHost := "smtp.example.com"
smtpPort := "587"
msg := []byte("To: " + to[0] + "\r\n" +
"From: " + from + "\r\n" +
"Subject: =?UTF-8?B?5byg5LiJ55WM?=\r\n" + // “测试邮件” Base64 编码
"MIME-Version: 1.0\r\n" +
"Content-Type: text/plain; charset=UTF-8\r\n\r\n" +
"这是一封 Go 发送的纯文本邮件。\r\n")
auth := smtp.PlainAuth("", from, password, smtpHost)
client, err := smtp.Dial(smtpHost + ":" + smtpPort)
if err != nil {
return fmt.Errorf("dial failed: %w", err)
}
defer client.Close()
if err = client.Auth(auth); err != nil {
return fmt.Errorf("auth failed: %w", err)
}
if err = client.Mail(from); err != nil {
return fmt.Errorf("mail from failed: %w", err)
}
for _, addr := range to {
if err = client.Rcpt(addr); err != nil {
return fmt.Errorf("rcpt to %s failed: %w", addr, err)
}
}
w, err := client.Data()
if err != nil {
return fmt.Errorf("data failed: %w", err)
}
_, err = w.Write(msg)
if err != nil {
return fmt.Errorf("write msg failed: %w", err)
}
err = w.Close()
if err != nil {
return fmt.Errorf("close data failed: %w", err)
}
return nil
}
发 HTML 邮件必须处理 Content-Type 多部分边界
HTML 邮件本质是 multipart/alternative 类型，需手动构造边界字符串（boundary），并确保正文和 HTML 版本都包裹在对应 boundary 段内。漏掉 -- 前缀、边界不一致、缺少空行，都会导致邮件客户端解析失败，显示为原始 MIME 文本。
- 边界字符串推荐用
time.Now().UnixNano()生成唯一值，避免硬编码重复 - 每个 part 的
Content-Type后必须跟空行，再写内容；结尾 boundary 必须以--开头且单独成行 - HTML 中的图片、CSS 不能直接引用本地路径，只能用内联 base64 或外部链接（后者依赖收件方网络环境）
smtp.SendMail 返回错误但没具体原因？检查底层连接状态
smtp.SendMail 是个便利函数，但它把连接、认证、发送全包在一起，一旦失败，错误信息常是模糊的 EOF 或 i/o timeout，根本看不出卡在哪步。生产环境必须拆开调用 smtp.Client 的各方法，逐层捕获错误。
需要创建、读取、编辑或处理 Word 文档（.docx / .dotx）时使用。触发词：'Word'、'word 文档'、'.docx'、'生成报告'、'制作合同/简历/方案/说明书'、'提取 word 内容'、'在文档里查找替换'、'给文档加页眉页脚/目录/表格'。也用于把任意内容排版成一份正式的 Word 文件。不要用它处理 PDF、Excel 或无关编程任务。中文创作场景尤其适合：小说大纲稿、投稿文档、合同、简历、工作总结。
立即学习“go语言免费学习笔记（深入）”；
- 调用
smtp.Dial后立即检查err，确认 TCP 层是否通 -
client.Auth失败大概率是账号密码错或服务商禁用了 SMTP，而非网络问题 -
client.Rcpt报错说明收件地址被拒（如格式错误、域名不存在、被对方服务器拉黑） - 最后
client.Data和w.Write出错，基本可定位为邮件内容格式违规（如 header 缺失、boundary 错位）
并发发信要控制连接池和重试逻辑
直接 for 循环调用 smtp.Dial 发 100 封邮件，大概率触发目标 SMTP 服务器的频率限制，返回 554 Too many connections 或被临时封 IP。Go 里没有内置 SMTP 连接池，得自己封装复用逻辑。
- 单个
*smtp.Client实例可复用多次SendMail，但不能并发调用（非线程安全），需加sync.Mutex - 更稳妥的做法是用
sync.Pool缓存已认证的 client，设置最大空闲数（如 5），超时自动关闭 - 对临时性错误（如
421 Service not available）应加入指数退避重试，但对5xx永久错误（如535 Authentication failed）必须立刻停止并告警
真正难的不是写出能发邮件的代码，而是让每封邮件的状态可追踪、失败原因可归类、重试不放大问题。SMTP 协议本身不提供投递回执，所有可靠性都要靠日志、监控和幂等设计兜底。
