直接用net/smtp需手动构造RFC 2822邮件体，易因编码、换行、边界符错误导致乱码或进垃圾箱；gomail.v2自动处理MIME、Base64、STARTTLS降级及明确错误提示，且v3已废弃、v1不支持Go modules，故验证码场景必须用gomail.v2。
为什么不用 net/smtp 直接发验证码邮件
直接用 net/smtp 发验证码邮件，等于手动拼 RFC 2822 邮件体——Date、MIME-Version、Content-Transfer-Encoding 全得自己算，中文乱码、换行符漏 \r\n、附件边界符错一位，都会导致收件方看到空白或进垃圾箱。验证码场景对成功率和时效敏感，不值得为省一个依赖去填这些坑。
gomail 自动处理 MIME 分隔、Base64 编码、Message-ID 生成、STARTTLS 降级逻辑，且错误提示明确（比如 535 5.7.8 Username and Password not accepted 直接指向账号权限问题）。
- 必须用
gopkg.in/gomail.v2，v3已废弃，v1不支持 Go modules - 验证码邮件通常无附件、纯 HTML + 纯文本双版本，
m.SetBody("text/plain", ...)和m.AddAlternative("text/html", ...)必须成对调用，否则 Outlook 等客户端可能不渲染 HTML - 别在
panic(err)里打印密码字段，生产环境日志要脱敏：用fmt.Sprintf("SMTP auth failed for %s", redactEmail(user))
如何配置 Gmail / 腾讯企业邮 / Outlook 的 SMTP 参数
不同服务商端口、加密方式、认证机制差异大，硬套一个配置十有八九连不上。
- Gmail：必须开两步验证，生成 App Password；用
smtp.gmail.com:587+ STARTTLS；用户名填完整邮箱（user@gmail.com），密码填 16 位 App Password - 腾讯企业邮：用
smtp.exmail.qq.com:465（SSL）或:587（STARTTLS）；需在邮箱后台开启 SMTP 服务；用户名是完整邮箱，密码为企业邮登录密码 - Outlook/Hotmail：用
smtp-mail.outlook.com:587；用户名填完整邮箱；密码是账户密码（非 App Password）；部分企业租户需启用「允许低安全性应用」策略
测试连通性时，先用 telnet smtp.gmail.com 587 确认网络可达，再检查 DNS 是否解析正常——常见报错 dial tcp: lookup smtp.gmail.com: no such host 多因代理或 DNS 污染。
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
立即学习“go语言免费学习笔记（深入）”；
微服务中怎么安全复用 SMTP 连接并异步发验证码
每次发验证码都新建 SMTP 连接（DialAndSend）开销大，且易触发频率限制；但直接全局复用一个 *gomail.Dialer 又有并发安全问题（内部状态未加锁）。
- 正确做法：用
d.Dial()获取一个长连接*gomail.Sender，在 goroutine 中复用它批量发送；每个请求分配独立gomail.Message，发完调用m.Reset() - 验证码场景建议加内存队列（如
chan *mailTask）+ worker pool 控制并发，避免突发流量打崩 SMTP 服务器或触发风控 - SMTP 连接空闲超时（如 Gmail 30 分钟）后会断开，需捕获
io.EOF或smtp: client disconnected错误，自动重拨 - 别把 SMTP 密码硬编码或塞进环境变量明文传参；用 secret manager（如 Vault）或 K8s Secret mount 后读取
验证码邮件正文怎么写才不进垃圾箱
HTML 正文不是越 fancy 越好，反而是简单、语义清晰、无外链、无图片更安全。
- 主题别含「验证码」「Verify」等敏感词，用「您的登录验证码」比「【系统】验证码」通过率高
- 正文必须同时提供
text/plain和text/html版本；纯文本版去掉所有标签，只留数字+有效期，例如：您的验证码是 123456，5 分钟内有效。 - HTML 版禁用
<img alt="如何在Golang系统中集成Gomail进行微服务异步验证码邮件发送" >、background-image、外部 CSS；内联样式仅用style="max-width:90%"这类基础属性；避免使用font-family等易被过滤的声明 - 发信域名必须和
From地址一致，且已配置 SPF/DKIM/DMARC 记录；否则 Gmail 直接标「未验证发件人」
真正卡住多数人的不是代码写法，而是 DNS 记录没配全、App Password 没开、或者测试时用个人 Gmail 帐号发大量验证码触发了 Google 的自动限频——这些得查 SMTP 返回码，而不是盯着 Go 日志看 panic。
