应优先使用 gomail 而非原生 net/smtp：它轻量、不依赖 cgo、自动处理 STARTTLS 和 AUTH 降级、生成合规 MIME/Message-ID，并简化 HTML 正文与附件添加。
Go 语言原生 net/smtp 包能发邮件，但直接用它发带附件、HTML 正文或认证失败时的错误提示不明确——这不是“能不能”，而是“要不要自己填坑”。真要稳定发运营/告警邮件，别硬刚裸包。
用 gomail 发带 HTML 和附件的邮件最省事
gomail 是目前 Go 生态里最轻量又靠谱的 SMTP 邮件库，不依赖 cgo，API 清晰，错误反馈比原生包强得多。它把 net/smtp 的底层细节（比如 AUTH 命令顺序、MIME 分隔符生成）全封装好了。
安装：
go get gopkg.in/gomail.v2
基本发送示例：
package main
import (
"gopkg.in/gomail.v2"
)
func main() {
d := gomail.NewDialer("smtp.gmail.com", 587, "user@gmail.com", "app-password")
m := gomail.NewMessage()
m.SetHeader("From", "user@gmail.com")
m.SetHeader("To", "receiver@example.com")
m.SetHeader("Subject", "Hello from Go")
m.SetBody("text/plain", "Hi there!")
m.AddAlternative("text/html", "<h1>Hi there!</h1>")
if err := d.DialAndSend(m); err != nil {
panic(err) // 注意：这里会暴露密码字段，生产环境需日志脱敏
}
}
常见注意点：
-
gomail.NewDialer第四个参数是应用专用密码（如 Gmail 开启两步验证后生成的 app password），不是账户登录密码 - 调用
m.AddAlternative添加 HTML 版本前，必须先调用m.SetBody设置纯文本版本，否则部分邮箱客户端只显示空白 - 附件用
m.Attach("/path/to/file.pdf")，路径必须存在且进程有读权限；内存中构建的文件建议用m.Attach("report.xlsx", gomail.SetCopyFunc(...))
net/smtp 手动发邮件时 AUTH 失败的典型原因
直接调 net/smtp 发送，最常见的报错是 535 5.7.8 Username and Password not accepted 或 432 4.3.2 Authentication mechanism not supported。根本不是密码错了，而是协议协商没对上。
关键点：
- Gmail / Outlook 等现代服务强制要求 STARTTLS，不能直连 465 端口再用 SSL（即所谓 SMTPS）；
net/smtp默认不自动升级加密，得手动调smtp.Dial+c.StartTLS - 认证方式默认只尝试
PLAIN，但某些企业邮箱只支持LOGIN；gomail内部会按服务器EHLO返回的AUTH列表自动降级尝试，裸包得自己写逻辑 - 用户名必须是完整邮箱地址（如
user@domain.com），不能只写user；部分服务器对大小写敏感
发信被当垃圾邮件？检查这三处头信息
即使 SMTP 连接成功、认证通过，收件方仍可能扔进垃圾箱。核心不在内容，而在基础头字段是否合规：
-
From域名必须和 SMTP 认证账号域名一致（From: service@myapp.com→ 必须用myapp.com的 SMTP 服务，不能混用 Gmail 账号发） - 缺失
Message-ID或格式非法（如含空格、无 @ 符）会导致部分 MX 服务器拒收；gomail会自动生成合规值，裸包得自己用fmt.Sprintf("", uuid.NewString(), domain) - 没设
Reply-To且From是 no-reply@ 类地址时，用户点“回复”会失败，触发反垃圾策略加权
真正难的不是连上 SMTP 服务器，是让每封邮件都稳定抵达收件箱——域名 SPF/DKIM/DMARC 配置、IP 信誉、发信频率限制，这些都远超代码层面。先用 gomail 把协议层跑通，再逐项补基础设施。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
