Java文本块需JDK≥15且编译级别设为15+，三引号必须换行开头、顶格结束，自动剥离各行公共前导空白，换行即换行、反斜杠不转义，慎用于正则、路径等敏感场景。
Java文本块怎么写才不会报错
Java 15 起正式支持文本块，但很多人一写就 java.lang.Error: text block not supported。根本原因是 JDK 版本和编译目标不匹配——哪怕你用的是 JDK 17，如果 javac 命令没加 --release 15 或 -source 15，或者 IDE 的 language level 没设对，就会直接拒识 """。
常见错误现象：unclosed string literal（IDE 显示红波浪）、illegal escape sequence（误把换行当转义）、Maven 编译失败但 IDEA 看着正常（IDEA 默认用自身 JDK 编译，和 Maven lifecycle 不同步）。
- 确认 JDK 版本：运行
java -version和javac -version必须 ≥ 15 - Maven 项目必须显式声明：
<source>15</source>和<target>15</target>在maven-compiler-plugin配置里 - IntelliJ：File → Project Structure → Project → Project SDK 和 Project language level 都要设为 15 或更高
- Eclipse：右键项目 → Properties → Java Build Path → Libraries → 右侧选中 JRE System Library → Edit → 选 JavaSE-15+
文本块里换行和缩进怎么算
文本块不是简单“多行字符串”，它的缩进是被自动剥离的——但只剥去所有非空行的**公共前导空白**，不是删掉每行开头所有空格。这就导致很多“看着对齐，实际内容错位”的问题。
使用场景：拼 SQL、JSON 模板、HTML 片段。一旦缩进处理不对，生成的 JSON 就会字段错行、SQL 多出空格导致语法错误。
立即学习“Java免费学习笔记（深入）”；
- 三引号后必须换行，否则第一行内容会被当成“前导空白参考行”而意外截断
- 最后一行的
"""必须顶格或与内容左对齐；如果它前面有空格，那些空格也会被当作“公共前缀”一并削掉 - 想保留某行开头空格？用
s（注意是反斜杠 + s，不是空格字符）显式转义，比如ssSELECT - 想保留末尾换行？在结束
"""后立刻跟一个换行符，否则结尾换行会被自动省略
文本块和普通字符串混用时要注意什么
文本块本质还是 String，可以和 +、String.format()、String::indent() 任意组合，但混合时机不对容易引发不可见的空白污染。
性能影响：文本块在编译期就被解析为常量字符串字面量，和普通字符串一样进字符串常量池，无运行时开销。但过度嵌套 """...""" + "xxx" + """...""" 会导致多个常量拼接，可能触发 StringBuilder 构造（JDK 9+ 优化后影响极小，但可读性下降）。
- 避免在文本块内部用
+拼接变量：别写"""Hello """ + name + """!"""，改用String.format("""Hello %s!""", name)或"""Hello %s!""".formatted(name)（JDK 15+） -
String::stripIndent()是手动剥离缩进的兜底方法，适用于动态构造文本块内容的场景，但一般不需要——标准文本块已自动 strip - 不要对文本块调用
.trim()：它会吃掉有意义的首尾换行，破坏结构；要用.stripTrailing()或.stripLeading()按需裁剪
哪些老代码迁移到文本块时最容易翻车
把原有带
、 的长字符串硬改成文本块，看似省事，实则埋雷。尤其涉及正则表达式、Windows 路径、XML/HTML 属性值时，换行语义和空白敏感度完全不同。
兼容性影响：文本块是语法糖，编译后字节码和普通字符串无异，所以只要运行环境是 JDK 15+，旧字节码无需改动也能加载文本块生成的 class；但源码级迁移必须人工校验空白行为。
- 正则字符串：原
"a\nb"表示 a、换行、b；文本块写成"""a b"""就真成了 a、反斜杠、n、b —— 正确写法是"""a b"""
（换行即换行）或"""a\nb"""（双反斜杠转义） - Windows 路径：原
"C:\\temp\\file.txt"改文本块不能直接抄，得写"""C: emp ile.txt"""（单反斜杠即可，文本块内反斜杠不转义） - XML 属性值：若原来靠
"<tag attr='"value"'>"</tag>拼接，改文本块后注意引号嵌套和换行是否破坏 XML 结构，建议配合String::translateEscapes()（JDK 15+）按需解义
最常被忽略的点：文本块的“自动缩进剥离”只看空格和制表符，不识别 IDE 的软缩进（如 4 个空格模拟 tab），也不感知不同编辑器对 tab 宽度的渲染差异。协作时务必统一用空格缩进，并在 .editorconfig 中固定 indent_style = space。
