smtp.SendMail 发送失败但无错误是因 auth 为空导致静默跳过认证；中文乱码需用 mime.FormatAddress 和 mime.WordEncoder 编码；超时应设 net.Dialer 或 context.WithTimeout；附件须用 multipart.NewWriter 自动生成 boundary 并调用 Close()。
smtp.SendMail 发送失败但没报错？检查 auth 参数是否为空
Go 的 smtp.SendMail 函数不会自动拒绝 nil 或空的 auth 参数，而是会静默跳过认证——结果就是大多数邮件服务商（如 Gmail、Outlook）直接拒收，返回 530 未认证错误，但 Go 层面不抛异常，err 为 nil，容易误判为“发送成功”。
- 必须显式传入非 nil 的认证对象，比如
smtp.PlainAuth，即使服务商支持无密码的 OAuth2，也要用对应 auth 实现 - Gmail 等已禁用“低安全性应用访问”，必须用 App Password 或 OAuth2，不能用账户明文密码
- 测试时加一句
if auth == nil { log.Fatal("missing auth") }，比事后查日志快得多
From 和 To 字段含中文就乱码？别手动拼接邮件头
直接在 to 或 from 字符串里写中文（如 "张三 <zhang>"</zhang>），SMTP 协议不识别 UTF-8，接收方客户端大概率显示问号或拆成乱码。标准库不处理 MIME 编码，得自己包一层。
- 用
mime.FormatAddress生成合规的 From/To 字段：mime.FormatAddress("张三", "zhang@example.com")→"=?UTF-8?B?5byg5LiJ?= <zhang>"</zhang> - 整个邮件正文（包括 Subject）也需用
mime.WordEncoder编码，否则中文主题在 Outlook 里可能被截断 - 别依赖
fmt.Sprintf拼接头部字段，SMTP 头部换行和空格敏感，一不小心就触发 501 Syntax error
发信超时卡死？设置 deadline 比调大 timeout 更可靠
smtp.SendMail 底层用 net.Dial 建连 + bufio.ReadWriter 交互，若网络中间件丢包或防火墙静默丢弃 SYN 包，它可能卡在 DNS 解析、TCP 握手或 SMTP 命令响应阶段，且默认无超时。
- 不要只设
net.DialTimeout，要对连接后所有 I/O 统一控时：用net.Dialer{Timeout: 10 * time.Second, KeepAlive: 30 * time.Second}+conn.SetDeadline - 更稳妥的做法是用
context.WithTimeout包裹整个流程，配合自定义net.Conn实现，避免阻塞 goroutine - 常见坑：本地开发用 127.0.0.1:25 测试时，Postfix/MailHog 启动慢，超时设太短（如 1s）会导致频繁失败，建议最低 5 秒
附件内容损坏？multipart.Writer 的边界符必须唯一且不可见
用 mime/multipart 构造带附件的邮件时，如果手动指定 boundary 字符串（如 "--myboundary"），而正文里恰好出现相同字符串，接收方解析器会提前切分，导致附件内容被截断或错位。
立即学习“go语言免费学习笔记（深入）”；
- 永远用
multipart.NewWriter自动生成 boundary：w := multipart.NewWriter(buf)，然后用w.Boundary()获取值，别硬编码 - 写完每个 part 后必须调用
w.Close()，否则结尾 boundary 缺失，部分邮箱（如 Apple Mail）会忽略整个附件 - 附件文件名含中文？用
mime.BEncoding.Encode编码Content-Disposition的 filename 参数，否则 iOS 邮件客户端可能显示空白名
最麻烦的不是写不对，是错误藏得深：认证失败不报错、中文乱码只在特定客户端出、超时卡住没日志、附件少几个字节却无法复现——这些都得靠边界检查和真实 SMTP 服务联调才能暴露。
