本文详解在使用 Mandrill（SMTP/API）发送邮件时，HTML 内容中 与 \n 换行行为不一致的根本原因，并提供跨通道兼容的解决方案，包括 MIME 类型设置、换行符标准化及 标签的合理使用。
本文详解在使用 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，导致全部内容挤在一行。反之，若改用
：
Hi {{.name}}<br/>
This is support.<br/>则 Mandrill API 显示正常，而 SMTP 通道却将
作为明文字符直接显示——造成“可见的
”而非换行。
根本原因在于：Mandrill API 默认将邮件体视为 text/html，而多数 SMTP 客户端（尤其传统 MTA）更倾向按 text/plain 解析未声明 MIME 类型的内容。HTML 中的 \n 无渲染意义，而
在纯文本模式下不被解析。
立即学习“前端免费学习笔记（深入）”；
✅ 正确解决方案（三步保障兼容性）
1. 明确声明 MIME 类型
始终在邮件头中显式指定 Content-Type，避免依赖服务端猜测：
-
若内容含 HTML 标签（如
,），设为：
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 class="brush:php;toolbar:false;" style="white-space: pre-wrap; font-family: inherit;"> Hi {{.name}}, This is support.保留所有空白符和换行，配合 white-space: pre-wrap 允许自动折行，兼顾可读性与兼容性。</p></li></ul><h4>4. Go 模板渲染最佳实践</h4><p>在 Execute 后立即处理换行与编码，避免中间状态污染：</p><pre class="brush:php;toolbar:false;">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，改用或
；
等语义标签
? 纯文本内容确保使用 \r\n 并声明 text/plain；
? Go 渲染后主动标准化换行符与编码。遵循以上原则，即可实现 Mandrill API 与 SMTP 通道下一致、可靠的邮件排版效果。
