本文目录导读：
- 目录导读
- 为什么你需要文本块？传统多行字符串之痛
- Java 13文本块核心语法——从零到一快速上手
- 实战案例：SQL、JSON与HTML三大场景
- 文本块进阶技巧——空格控制、格式化与性能
- 常见陷阱与最佳实践——避坑指南
- FAQ问答——解决你最关心的5个问题
目录导读
- 为什么你需要文本块？ ——传统多行字符串之痛
- Java 13文本块核心语法 ——从零到一快速上手
- 实战案例：SQL、JSON与HTML三大场景
- 文本块进阶技巧 ——空格控制、格式化与性能
- 常见陷阱与最佳实践 ——避坑指南
- FAQ问答 ——解决你最关心的5个问题
为什么你需要文本块？传统多行字符串之痛
在Java 13之前，编写多行字符串堪称一场灾难，想象一下,你需要嵌入一段SQL查询：
String query = "SELECT id, name, email\n" +
"FROM users\n" +
"WHERE status = 'ACTIVE'\n" +
"ORDER BY created_at DESC";
每个\n转义、每个拼接都让人抓狂，如果遇到JSON或HTML，更是雪上加霜——双引号需要转义，反斜杠需要转义,代码可读性几乎为零。
核心痛点总结：
- 转义字符泛滥，极易出错
- 代码臃肿冗长，难以维护
- 视觉上无法真实反映内容结构
Java 13正式引入文本块（Text Blocks），这是一次革命性的语法升级，旨在彻底解决上述问题，它并非简单的语法糖,而是对字符串字面量的原生扩展。
Java 13文本块核心语法——从零到一快速上手
文本块使用三个双引号作为定界符,语法极其简洁：
String textBlock = """
这是第一行
这是第二行
这是第三行
""";
关键语法规则：
- 开始定界符：后必须紧跟换行符（允许有空白字符）
- 结束定界符：的位置决定缩进基线
- 自动缩进处理：编译器会根据结束定界符的位置，移除每行公共的前导空白
- 保留换行符：每行末尾的
\n被保留（除非显式使用）
与普通字符串的关系：
- 文本块是
java.lang.String的实例，编译后与普通字符串完全等价 - 可以使用所有
String方法，如contains()、split()等 - 通过
String::formatted或String::format实现动态插值
最小示例：
String json = """
{
"name": "Java",
"version": 13,
"features": ["text blocks", "switch expressions"]
}
""";
System.out.println(json);
输出结果完全保留了JSON的格式结构,无需任何转义。
实战案例：SQL、JSON与HTML三大场景
动态SQL构建
String getUserQuery = """
SELECT u.id, u.username, u.email, r.role_name
FROM users u
JOIN user_roles ur ON u.id = ur.user_id
JOIN roles r ON ur.role_id = r.role_id
WHERE u.status = 'ACTIVE'
AND u.last_login >= ?(1)
ORDER BY u.last_login DESC
LIMIT ?(2)
""";
// 配合PreparedStatement使用
PreparedStatement ps = connection.prepareStatement(getUserQuery);
ps.setDate(1, sinceDate);
ps.setInt(2, limit);
优势：SQL格式一目了然，无需手动拼接空格或换行,数据库索引可视化直接调整。
JSON配置文件
String openAIConfig = """
{
"model": "gpt-4",
"messages": [{
"role": "user",
"content": "生成一个Java文本块示例"
}],
"temperature": 0.7,
"max_tokens": 1500
}
""";
// 直接送入HTTP请求体
httpRequest.body(jsonConfig);
优势：双引号不需转义,可直接复制从API文档获取的JSON原样。
HTML模板渲染
String emailTemplate = """
<html>
<body>
<h1 style="color: #333;">欢迎加入，${name}!</h1>
<p>请点击以下链接验证您的邮箱：</p>
<a href="${verificationUrl}">激活账户</a>
<p style="font-size: 12px; color: #999;">该链接24小时内有效。</p>
</body>
</html>
""".replace("${name}", userName)
.replace("${verificationUrl}", url);
优势：CSS样式中的和引号不再干扰,结构化内容肉眼可读。
文本块进阶技巧——空格控制、格式化与性能
1 精确控制空格
文本块有一个“偶然”的设计：所有行都会移除公共缩进，但末尾的空白会被保留，为了精确控制,提供了两个转义序列：
- （行末反斜杠）：抑制换行符，相当于续行符
\s：显式空格，防止编译器移除尾部空格
String example = """
第一行\
第二行
""";
// 结果为："第一行第二行\n"
String withTrailing = """
value: \s
""";
// 结果为："value: \n"（保留了两个空格）
2 模板引擎替代方案
文本块原生支持formatted()方法，比手动replace更优雅：
String greeting = """
Hello, %s! Your order #%d is ready.
Shipping to: %s
""".formatted("Alice", 1024, "123 Main St");
这比String.format更直观,且保持多行结构。
3 性能考量
- 文本块是编译期常量（若不含动态表达式），存储在常量池中
- 与拼接不同，不会产生中间字符串对象
- 运行时使用完全等价于普通字符串，无额外开销
对比测试：
// 传统方式（每执行一次创建多个临时对象）
String s1 = "line1\n" + "line2\n" + "line3";
// 文本块（编译期优化为单一常量）
String s2 = """
line1
line2
line3
""";
JVM字节码层面，文本块直接对应ldc指令加载常量,性能更优。
常见陷阱与最佳实践——避坑指南
意外的前导空行
String wrong = """
内容
""";
// 第一行是空行！因为开始定界符后的换行是内容的一部分
解决：开始定界符后紧跟内容,不要留空行。
缩进依赖外部上下文
class Test {
void method() {
String sql = """
SELECT 1
"""; // 编译器根据结束符位置剥离缩进
}
}
注意：编辑器中的代码缩进会被移除,但内容本身的缩进仅保留相对差异。
不可变性和intern()
文本块是String对象，具有不可变性，如果频繁使用相同内容的文本块，建议显式调用intern()以复用常量池实例。
String block1 = """
hello
""";
String block2 = "hello\n";
System.out.println(block1.equals(block2)); // true
最佳实践清单：
- ✅ 始终使用文本块处理SQL、JSON、HTML、XML等结构化文本
- ✅ 使用
formatted()进行动态插值，避免手动拼接 - ✅ 保持结束定界符独立一行，与内容缩进对齐
- ❌ 不要在文本块中混用拼接
- ❌ 不要用文本块存放二进制数据（使用Base64编码）
FAQ问答——解决你最关心的5个问题
Q1：文本块需要Java 13吗？之后版本有变化吗？
文本块在Java 13作为预览特性（
--enable-preview），Java 15正式永久化，从Java 15起，无需任何编译参数即可使用，如果你的项目运行在Java 15+，完全放心使用，在Java 13/14中必须加--enable-preview且不推荐生产环境。
Q2：文本块能否包含三个双引号？
可以，但需要转义其中一个：，只要不连续出现三个双引号即可，例如包含或都无问题，要表现,写成即可。
Q3：如何让文本块中的每行末尾都带空格？
使用
\s，每行末尾添加\s，编译器会保留该空格。\s"，注意\s会被转义为一个普通空格字符。
Q4：文本块可以用于正则表达式吗？
绝对可以，正则中的反斜杠不再需要双重转义,极大提升可读性：
String regex = """ (?<year>\d{4})-(?<month>\d{2})-(?<day>\d{2}) """;但注意
\d仍然识别为数字，无需写\\d。
Q5：文本块和Scala/Kotlin的多行字符串有何区别？
Java文本块是语言原生支持，且经过JLS规范定义，Scala的三引号不支持自动缩进移除，Kotlin的
trimIndent()是运行时方法，Java在编译期就完成处理，性能无损耗,且与Java生态无缝集成。
