本文详解在使用 Mandrill（SMTP/API）发送邮件时，HTML 内容中 <br/> 与 \n 换行行为不一致的根本原因，并提供跨通道兼容的解决方案，包括 MIME 类型设置、换行符标准化及 <pre> 标签的合理使用。
本文详解在使用 mandrill（smtp/api）发送邮件时，html 内容中 `
` 与 `\n` 换行行为不一致的根本原因，并提供跨通道兼容的解决方案，包括 mime 类型设置、换行符标准化及 `
` 标签的合理使用。</p><p>在通过 Mandrill 发送邮件时，开发者常遇到一个典型兼容性问题：同一套 Go 模板（.tpl）在 Mandrill API 和 SMTP 通道下呈现截然不同的换行效果。例如：</p><pre class="brush:php;toolbar:false;">Hi {{.name}},
This is support.
该模板含纯 \n 换行，在 SMTP 通道中能正确渲染为多行文本；但 Mandrill API（默认以 HTML 模式解析内容）会忽略 \n，导致全部内容挤在一行。反之，若改用 <br/>：
Hi {{.name}}<br/>
This is support.<br/>则 Mandrill API 显示正常，而 SMTP 通道却将 <br/> 作为明文字符直接显示——造成“可见的 <br/>”而非换行。
根本原因在于：Mandrill API 默认将邮件体视为 text/html，而多数 SMTP 客户端（尤其传统 MTA）更倾向按 text/plain 解析未声明 MIME 类型的内容。HTML 中的 \n 无渲染意义，而 <br/> 在纯文本模式下不被解析。
立即学习“前端免费学习笔记（深入）”；
✅ 正确解决方案（三步保障兼容性）
1. 明确声明 MIME 类型
始终在邮件头中显式指定 Content-Type，避免依赖服务端猜测：
若内容含 HTML 标签（如 <br/>, <p>），设为：
Content-Type: text/html; charset=utf-8若内容为纯文本（仅含 \n），设为：
Content-Type: text/plain; charset=utf-8
⚠️ 注意：Mandrill API 的 message.html 字段强制按 HTML 解析，message.text 字段才按纯文本处理。务必根据字段用途匹配内容格式。
2. 统一换行符为 \r\n（CRLF）
RFC 5322 规定邮件正文必须使用 \r\n 作为行结束符。Go 的 strings.ReplaceAll() 或 fmt.Fprintf 可安全转换：
// 渲染后标准化换行符 temp := doc.String() temp = strings.ReplaceAll(temp, "\n", "\r\n") // 替换 LF → CRLF temp = strings.ReplaceAll(temp, "\r\r\n", "\r\n") // 防止重复替换产生 \r\r\n
此步对 SMTP 通道尤为关键，部分老旧 MTA 会因仅含 \n 而截断或错乱换行。
3. 灵活选用语义化标签（HTML 场景）
当必须使用 HTML 模式时，避免依赖 \n 实现换行，而应采用语义化、可预测的 HTML 结构：
-
✅ 推荐（清晰、兼容、可维护）：
<p>Hi {{.name}},</p> <p>This is support.</p> -
✅ 替代方案（保留原始排版意图）：
<pre style="white-space: pre-wrap; font-family: inherit;"> Hi {{.name}}, This is support. </pre><pre> 保留所有空白符和换行，配合 white-space: pre-wrap 允许自动折行，兼顾可读性与兼容性。
4. Go 模板渲染最佳实践
在 Execute 后立即处理换行与编码，避免中间状态污染：
frame, err := template.New("email").Parse(*templateString)
if err != nil {
return "", err
}
var doc bytes.Buffer
if err := frame.Execute(&doc, *parameters); err != nil {
return "", err
}
// 步骤1：HTML 模式下转义特殊字符（防 XSS），再标准化换行
htmlBody := template.HTMLEscapeString(doc.String())
htmlBody = strings.ReplaceAll(htmlBody, "\n", "\r\n")
// 步骤2：若需同时提供 text/plain 版本，可另建纯文本模板或 strip HTML 标签
textBody := html2text(htmlBody) // 使用第三方库如 github.com/asciimoo/html2text总结
邮件换行不一致的本质是 MIME 类型与内容格式的错配。解决的关键在于：
? 明确声明 Content-Type（非可选）；
? HTML 内容弃用 \n，改用 <p> 或 <br> 等语义标签；
? 纯文本内容确保使用 \r\n 并声明 text/plain；
? Go 渲染后主动标准化换行符与编码。
遵循以上原则，即可实现 Mandrill API 与 SMTP 通道下一致、可靠的邮件排版效果。
