StringBuilder不生成PDF，仅高效拼接字符串；真正生成PDF需用iText等库将StringBuilder组装的HTML等内容渲染为二进制PDF文件。
StringBuilder 本身不生成 PDF，它只负责高效拼接字符串；真正生成 PDF 需要借助 PDF 库（如 iText、Apache PDFBox 或 Flying Saucer）。关键在于：把 StringBuilder 拼出的结构化文本（如 HTML 或纯文本内容）作为数据源，交给 PDF 库渲染。直接用 StringBuilder “拼 PDF 文件” 是错误理解——PDF 是二进制格式，不是字符串。
先用 StringBuilder 组装语义化内容（推荐 HTML）
报表内容通常有标题、表格、换行、加粗等需求。纯字符串拼接难维护、易出错；HTML 字符串则结构清晰、与 PDF 渲染器天然兼容。
- 用 StringBuilder 逐段追加 HTML 片段，比如：<h2>销售报表</h2><table>...</table>
- 避免手动拼接 <tr><td>...</td></tr> 等嵌套标签时出错，可封装小方法（如 appendTableRow(sb, "产品A", "1200元")）
- 对动态数据做 HTML 转义（如用 StringEscapeUtils.escapeHtml4()），防止 XSS 或标签解析失败
选对 PDF 库，让 HTML → PDF 一步到位
不建议用 StringBuilder 拼原始 PDF 字节或低层指令（复杂且极易出错）。推荐路径：
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
- iText 7 + html2pdf：官方支持 HTML 转 PDF，兼容 CSS，适合带样式的报表
- Flying Saucer (XHTMLRenderer)：轻量、专注 XHTML/CSS 渲染，适合简单报表
- 若必须用纯文本（如打印日志类报表），可用 iText 的
ColumnText或Document手动添加段落，此时 StringBuilder 拼好每行文本后，调用document.add(new Paragraph(line))
性能优化要点（避免常见坑）
高频报表场景下，StringBuilder 效率虽高，但瓶颈常在 PDF 渲染环节：
立即学习“Java免费学习笔记（深入）”；
- StringBuilder 初始化指定合理容量（如
new StringBuilder(8192)），减少扩容拷贝 - 避免在循环内反复创建 StringBuilder 实例；复用或使用局部变量即可
- HTML 内联样式比外部 CSS 更快（无网络/IO 开销），但别过度嵌套；CSS 复杂度高时，iText 渲染会明显变慢
- 图片尽量用本地路径或 Base64 内联（远程 URL 会阻塞渲染），Base64 字符串也建议用 StringBuilder 拼接
一个极简示例（iText + HTML）
拼 HTML → 转 PDF，全程无需操作 PDF 结构：
StringBuilder html = new StringBuilder();
html.append("<html><body>");
html.append("<h3>订单汇总（").append(LocalDate.now()).append("）</h3>");
html.append("<p>总金额：<strong>¥").append(total).append("</strong></p>");
html.append("</body></html>");
// 用 iText html2pdf 渲染
ConverterProperties props = new ConverterProperties();
PdfWriter writer = new PdfWriter("report.pdf");
HtmlConverter.convertToPdf(html.toString(), writer, props);
