java中用stringbuilder动态组装邮件正文应分段拼接、条件控制、避免重复换行；按语义拆分为标题、问候、主体、签名等块，封装处理；列表用string.join或手动控制换行，确保格式整洁。
在 Java 中用 StringBuilder 动态组装邮件正文，核心是“分段拼接 + 条件控制 + 避免重复换行”，而不是简单地连续 append。它比字符串拼接高效，又比直接用模板引擎轻量，特别适合业务逻辑清晰、格式相对固定的邮件场景（比如通知类、报表摘要类邮件）。
按语义分块构建，提升可读性和可维护性
不要把整封邮件写成一行 sb.append("Hi ").append(name).append(",\nYour order ").append(id)... 。应按逻辑拆成标题、问候、主体内容、签名等块，每块独立处理：
- 先初始化
StringBuilder sb = new StringBuilder(); - 用方法或代码块封装各部分，例如：
// 问候段落sb.append("Dear ").append(customerName).append(",\n\n");
// 订单摘要段落sb.append("Your recent order #").append(orderId).append(" has been shipped.\n");sb.append("Tracking number: ").append(trackingNo).append("\n\n"); - 这样修改某一段（比如加个预计送达时间）时，只改对应几行，不干扰其他逻辑
动态插入列表或条件内容，注意换行与空行控制
遇到订单明细、失败原因列表、多状态提示等需要循环或判断的内容，要主动管理换行符，避免开头/结尾多出空行：
- 列表建议用
String.join("\n", items)拼好再append，或手动控制首尾不加换行：if (!items.isEmpty()) {sb.append("Items:\n");for (int i = 0; i <br><code> sb.append("- ").append(items.get(i));if (i <br><code> }sb.append("\n\n"); // 段后空行} - 条件内容（如仅退款成功才显示退款金额）直接用
if包裹append，不预留占位符
注意字符编码与特殊符号转义（尤其 HTML 邮件）
如果邮件是 text/html 类型，StringBuilder 拼的是 HTML 片段，需额外处理：
- 用户输入的姓名、地址等可能含
、<code>&，直接拼会破坏 HTML 结构 → 应先用工具类转义（如StringEscapeUtils.escapeHtml4()），再append - 避免在
StringBuilder中硬编码<br>或<p></p>；统一用语义方法封装，比如：appendLine(sb, "Order date: " + formatDate(orderDate)); // 内部自动加 <br> - 纯文本邮件则只需确保换行用
\n（服务端发信通常兼容），无需 HTML 标签
生成完成后，及时转成不可变字符串并复用 StringBuilder 实例
邮件正文确定后，调用 sb.toString() 获取最终内容。若需批量发送多封邮件，可重用同一个 StringBuilder 实例：
- 每次拼新邮件前调用
sb.setLength(0);清空内容（比新建对象更省内存） - 不要在循环中反复
new StringBuilder()，除非单次内容极小且数量极少 - 若邮件内容含敏感信息（如 token、手机号），拼完立即调用
sb.setLength(0)清除，降低内存泄露风险
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
