JDK-02 | 我为什么越来越喜欢用 Java 的 Text Blocks

这是专栏第 2 篇。
如果第一篇record是在“模型表达”上让我轻松，Text Blocks则是在“日常编码和代码审查”上让我明显省力。

我先给结论：Text Blocks不只是少写几个+，它真正解决的是多行文本在代码中的可读性、可评审性和可回归性。

一、我为什么会认真用这个特性

在 JDK 8 项目里，多行字符串通常会长这样：

• +拼接几十行；
• 到处是\n、\"；
• 改了一个空格或换行，review 很难第一时间看出来到底改了格式还是改了语义。

这件事单看不大，但在 SQL、JSON、模板片段这种高频场景里，长期成本很高。
我自己遇到过几次线上回归，根因都不是业务逻辑，而是字符串拼接细节漏改。

二、版本信息（含 JEP）

• JEP 355：Java 13（预览）
• JEP 368：Java 14（第二次预览）
• JEP 378：Java 15（正式）

如果你在 13/14 使用，需要--enable-preview。
我更建议在 JDK 17/21 直接用正式能力，不走预览链路。

三、Text Blocks真正带来的变化

1. 文本“所见即所得”

多行内容可以按原始结构写在代码里，SQL 看起来像 SQL，JSON 看起来像 JSON。

2. 转义噪音显著减少

字符串不再充满\"和\n，review 的注意力会回到业务内容本身。

3. 换行和缩进策略可控

它不是“随便写都对”，而是把换行/缩进规则显式化了。
你可以用stripIndent()、indent()、formatted()做最终收口。

四、适配场景 / 不适配场景

我会优先用在这些地方：

• 多行 SQL、JSON、XML、HTML；
• 测试里的预期文本、快照断言；
• 配置片段、脚本片段、邮件模板。

我会谨慎甚至不使用在这些地方：

• 高频动态拼接、模板结构经常变化；
• 需要兼容 JDK 8 运行时且短期无法升级；
• 团队没有统一“尾换行”和“缩进基线”约定的仓库。

五、从 JDK 8 升上来，我重点看这 5 件事

1) 尾部换行语义

Text Blocks