Gin中用gomail发HTML邮件需显式设置Content-Type为text/html; charset=utf-8并用bytes.NewReader写入HTML，禁用外部CSS；邮件布局须用table+行内style；异步发送须用goroutine加缓冲channel防阻塞。
为什么Gin里直接用gomail发HTML邮件会乱码或样式丢失
因为gomail默认不设置Content-Type为text/html; charset=utf-8，且未声明MIME边界，浏览器解析时会当成纯文本处理。Gin的c.Writer和gomail是两套IO体系，不能混用——别试图把邮件内容写进HTTP响应里。
- 必须显式调用
msg.SetHeader("Content-Type", "text/html; charset=utf-8") -
gomail的SetBody只支持text/plain；发HTML得用SetHeader+bytes.NewReader([]byte(html)) - 内联CSS必须写在
<style></style>里，外部CSS文件、@import、link标签全部无效
如何让Go-Email渲染出带按钮和间距的现代邮件模板
邮件客户端（尤其是Outlook、Apple Mail）对CSS支持极差，Flex/Grid基本不可用，padding/margin在部分客户端被忽略。唯一可靠的方式是用table布局 + 行内style + 内联字体/颜色定义。
- 按钮必须用
<table><tr><td style="background:#007bff;border-radius:4px"><a href="..." style="display:block;color:#fff;padding:12px 24px;text-decoration:none">点击确认</a></td></tr></table> - 所有关键样式（
font-family、color、line-height）必须写在对应标签的style属性里 - 避免使用
rem、vh/vw，统一用px；字号建议14px起步，小屏设备才看得清
Gin中异步发送邮件时如何避免阻塞HTTP请求
直接在Gin handler里调用dialer.DialAndSend会同步等待SMTP响应，超时或网络抖动会导致接口卡死。必须剥离到goroutine，但要注意错误无法返回给客户端，且需防goroutine泄漏。
- 用带缓冲的channel接收发送结果：
done := make(chan error, 1)，然后go func() { done - 别用
go dialer.DialAndSend(...)裸启动——没上下文控制，失败日志都难捕获 - 如果需要反馈，把任务ID写入DB，前端轮询状态；不要试图在HTTP响应里等邮件发完
- SMTP连接池可复用
gomail.NewDialer实例，但dialer.DialAndSend本身不是线程安全的，每次发信建议新建gomail.Message
调试邮件样式时最常忽略的三个细节
本地测试看到的网页效果≠真实邮箱效果。Gmail会删掉里的所有内容，Outlook把div全转成span，iOS Mail强制重设font-size。真正起作用的只有三件事：
立即学习“go语言免费学习笔记（深入）”；
- 所有
<table>必须带<code>cellspacing="0"和cellpadding="0"，否则行间有白边 -
<img alt="Go语言Gin框架配合Go-Email库发送美观的通知邮件" >标签必须带width/height属性（不能只靠CSS），否则某些客户端缩放错乱 - 主题行别用emoji——Gmail安卓版会把它替换成方块，且可能触发垃圾邮件过滤
发完立刻去Gmail、Outlook、Apple Mail三个客户端手动查收，截图比任何预览工具都准。
