Java长文本拼接需分层选型：静态多行用Text Blocks（Java15+）配trimIndent()和formatted()；动态逻辑用StringBuilder预估容量、链式append、lineSeparator()；列表合并用String.join()，局部格式化用formatted()；须避循环+=、用户输入直拼、日志未判级格式化等坑。
Java 中处理长文本的格式化拼接，核心是兼顾可读性、性能与安全性。不能只靠 + 拼接，也不能无脑用 String.format()；得按内容结构、生成方式、运行环境来分层选型。
用 Text Blocks（Java 15+）写静态多行模板
适合 SQL、JSON、帮助说明、HTML 片段等结构固定、换行缩进重要的长文本。
- 三重引号
"""包裹，自动保留换行和内部缩进，天然去首尾空行 - 配合
trimIndent()清理嵌套代码中的多余左缩进，避免手动删空格 - 变量插入用
.formatted(...)或String.format()，不破坏结构
例如：
String sql = """SELECT u.name, u.email, COUNT(o.id) AS order_count
FROM users u
LEFT JOIN orders o ON u.id = o.user_id
WHERE u.status = ?
GROUP BY u.id
""".trimIndent().formatted(status);
用 StringBuilder 动态构建带逻辑的长文本
适合内容需条件判断、循环追加、字段动态增减的场景，比如日志聚合、配置生成、邮件正文拼装。
立即学习“Java免费学习笔记（深入）”；
- 初始化时预估容量（如
new StringBuilder(1024)），减少扩容开销 - 链式调用
append()，支持字符串、数字、布尔、对象，类型安全不报错 - 每段之间用
System.lineSeparator()换行，保证跨平台兼容（不用硬写\n）
例如：
StringBuilder mail = new StringBuilder();mail.append("Dear ").append(name).append(",").append(System.lineSeparator());
if (hasDiscount) {
mail.append("You have a special discount!").append(System.lineSeparator());
}
mail.append("Order ID: ").append(orderId);
String content = mail.toString();
用 String.join() 和 String.format() 对齐字段或分段组合
适合把已有的字符串列表按规则合并，或对齐列宽、补零、控制精度等格式化需求。
-
String.join(System.lineSeparator(), lines)比循环+=更简洁高效 -
String.format("%-20s | %8d | %6.2f", name, count, price)控制字段宽度与对齐 - 长文本中局部格式化（如金额、日期）仍推荐
formatted()，比String.format()更直观
避开几个典型坑
长文本处理容易因小疏忽引发性能下降或安全风险：
- 不在循环里用
+=拼接长文本——每次生成新String，GC 压力陡增 - 不直接拼接用户输入到 SQL 或脚本中——必须用
PreparedStatement或模板引擎，而非字符串操作 - 日志类长文本先判级别再格式化——避免
debug关闭时仍执行String.format()开销 - 不用
concat()或StringJoiner处理复杂动态内容——它们适用场景窄，灵活性不如StringBuilder
