StringBuilder 不参与模板引擎渲染，仅用于拼接静态 HTML 骨架、合并纯文本模板片段、构建内联脚本/样式及轻量级非模板 HTML；模板引擎负责动态数据注入与逻辑渲染，二者应分工协作而非混用。
明确分工：什么时候该用 StringBuilder？
StringBuilder 适合在以下场景辅助 HTML 骨架生成：
-
拼接固定结构的 HTML 外壳：比如统一的
<!DOCTYPE html><html lang="zh">...</html>框架，不含变量或条件逻辑 - 组装多个静态模板片段：例如将 header.html、footer.html 等纯文本文件内容读入后，用 StringBuilder 合并成一个完整 HTML 字符串（再传给模板引擎做最终数据填充）
-
构建内联脚本或样式块：动态生成 JS 数组、CSS 类名列表等，拼成
<script>var data = [...];</script>后追加到页面中 - 非模板路径下的轻量级 HTML 生成：如日志导出、邮件正文、API 响应中的简易 HTML 片段，无需引入整套模板引擎
模板引擎渲染时，StringBuilder 不直接参与
Thymeleaf、FreeMarker 等引擎的工作流程是：
- 加载 .html 或 .ftl 模板文件（磁盘/类路径）
- 解析其中的表达式（如
${title}、#if） - 将 Java 数据模型（Map、Bean）注入模板上下文
- 执行渲染，输出最终 HTML 字符串
这个过程由引擎内部的字符缓冲机制完成（如 FreeMarker 使用 StringWriter，Thymeleaf 使用 TemplateOutput），你不需要、也不应该用 StringBuilder 去“手动拼接”模板引擎正在渲染的内容。
高效配合的实用写法示例
假设你要生成一个带自定义头部 + 动态主体 + 统一尾部的页面，且主体部分由 Thymeleaf 渲染：
立即学习“Java免费学习笔记（深入）”；
// 1. 用 StringBuilder 快速组装静态骨架
StringBuilder html = new StringBuilder();
html.append("<!DOCTYPE html>");
html.append("<html lang=\"zh\"><head><meta charset=\"UTF-8\">");
html.append("<title>").append(pageTitle).append("</title></head>");
html.append("<body class=\"page-").append(pageType).append("\">");
// 2. 渲染动态主体（交给 Thymeleaf）
Context context = new Context();
context.setVariable("items", items);
String bodyHtml = templateEngine.process("list-body", context); // list-body.html 模板
// 3. 追加动态内容 + 静态尾部
html.append(bodyHtml);
html.append("<footer><p>© 2026 All rights reserved.</p></footer>");
html.append("</body></html>");
String finalHtml = html.toString(); // 最终结果
这种组合既保持了模板引擎的可维护性，又利用 StringBuilder 避免了字符串重复创建开销。
性能与可读性的平衡建议
- 单次拼接少于 5–10 次 append → 直接用
+也无妨，JVM 会自动优化 - 涉及循环拼接（如遍历 List 生成 <li>）、或拼接次数不确定 → 必须用 StringBuilder
- HTML 结构复杂、含条件/循环/国际化 → 全部交给模板引擎，别用 StringBuilder “硬编码”逻辑
- 避免把 StringBuilder 当作“轻量模板引擎”来用：一旦出现
if (x) sb.append("..."); else sb.append("...")，就该考虑迁移到真正的模板中了
