java使用文本块告别字符串拼接-CFANZ编程社区

作为Java开发者，处理多行字符串（比如SQL、JSON、HTML模板）绝对是日常任务之一。在Java 15（正式在17稳定）之前，我们是怎么做的呢？通常是：

痛苦的拼接： 使用 + 号连接，代码又长又乱，可读性极差。
转义地狱： 大量使用 \n 换行符和 \" 转义引号，眼睛都看花了。
String.join() 或 StringBuilder：稍好，但依然不够直观。

示例：一段简单的JSON字符串，老写法：

String oldJson = "{\n" +
                 "  \"name\": \"Alice\",\n" +
                 "  \"age\": 30,\n" +
                 "  \"city\": \"New York\"\n" +
                 "}";
System.out.println(oldJson);

看着就头疼，对吧？维护起来更麻烦！

✨ 救星降临：文本块 (Text Blocks)

Java 17（预览版始于13、14）正式引入了文本块，彻底改变了游戏规则！它的核心思想是：用三个双引号 """ 作为界定符，原样保留字符串的格式（包括换行和缩进）。

同样那段JSON，用文本块写：

java

String jsonBlock = """
                   {
                     "name": "Alice",
                     "age": 30,
                     "city": "New York"
                   }
                   """;
System.out.println(jsonBlock);

瞬间清爽！ 优点显而易见：

可读性飙升： 代码中的字符串格式和最终输出格式完全一致，一目了然。
告别转义： 双引号 " 在文本块内部不需要转义！（除非连续三个 """）。
维护简单： 修改字符串内容就像修改普通文本一样方便。
减少错误： 少了转义符，手滑打错的概率大大降低。

📌 关键点与注意事项

界定符： 开头三个 """ 后必须紧跟换行符。结束的三个 """ 可以单独一行，也可以跟在内容后面（影响最后一行内容的缩进）。
缩进处理：

编译器会自动去除文本块内容每行开头与结束界定符左边对齐位置之间的空白（空格和制表符）。这使得你可以将文本块与代码对齐，而不会在最终字符串中引入多余的前导空格。
字符串内部的空格和缩进会被保留。

转义：

内部的双引号 " 不需要转义。
如果需要包含三个连续的双引号 """，需要转义其中至少一个（如 ""\"）。
行尾的 \ 字符用于阻止换行。编译器会移除这个 \ 以及它后面紧跟的换行符和任何前导空白，让下一行内容接在本行后面。

\s 转义序列： 表示一个强制保留的空格（不会被自动去除的空白）。这在需要保留行首特定空格时很有用。

进阶示例：带格式的SQL查询

java

String query = """
               SELECT id, name, email
               FROM users
               WHERE status = 'ACTIVE'
                 AND signup_date > :startDate
               ORDER BY name ASC
               """;
// 注意：结束 """ 的位置决定了内容最小缩进的基线。