Java15多行字符串定义方法

Java 15 引入的文本块（Text Blocks）通过三重双引号 `"""` 简洁优雅地定义多行字符串，它并非运行时新类型，而是编译期语法糖，能智能裁剪最小公共缩进、保留源文件换行符，但不支持嵌套与插值；正确使用需确保 JDK 15+ 及 IDE 语言级别设置到位，同时警惕换行符跨平台差异、`"""` 转义陷阱和缩进计算规则——看似简单，实则细节决定成败，尤其在配置、SQL 或正则等对空白和换行敏感的场景中，稍有不慎就可能引发隐蔽的运行时故障。

Java 15+ 怎么写多行字符串？用 """ 包起来就行

Java 15 引入了文本块（Text Blocks），本质就是用三个双引号 """ 包裹字符串内容，自动处理换行和基础缩进。它不是“增强版 String”，而是编译期语法糖，最终仍生成普通 String 对象。

常见错误是把 """ 当成注释或模板字面量（像 JS 的 `），结果编译报错：error: illegal line end in string literal——说明你还在用 Java 14 或更低版本，或者 IDE 没设对语言级别。

• 必须用 Java 15+，且编译器/IDE 设置语言级别为 --release 15 或更高
• 开头 """ 必须独占一行，结尾 """ 也必须独占一行
• 内容首行换行后的内容，会以**第一行非空行的缩进量为基准**自动去前导空格（不是删所有空格）

文本块缩进怎么算？看第一行非空行的左边界

文本块不会傻乎乎地砍掉所有空格，而是按“最小公共缩进”裁剪：它扫描所有非空行，找出每行开头的空格数，取最小值，再从每行删掉这么多空格。

比如下面这段：

String html = """
    

      
Hello
    
    """;

三行非空内容的前导空格数分别是 4、6、4 → 最小是 4 → 每行都删 4 个空格，最终字符串里

前只剩 2 个空格。

• 如果某行全空（只含空格或制表符），它参与缩进计算，但不参与“非空行”判断
• 想保留左侧空格？在需要的位置加 \s（U+00A0 不间断空格）或故意让第一行非空行缩进为 0
• 结尾 """ 所在行的缩进**完全不影响内容**，它只决定换行符是否包含在字符串末尾

换行符是 \n 还是 \r\n？取决于源码文件本身

文本块里的换行符直接继承源文件的换行约定：Unix 系统下保存为 LF（\n），Windows 下为 CRLF（\r\n）。Java 不做统一转换，也不提供跨平台标准化选项。

这会导致问题：同一段文本块，在不同系统 checkout 后编译出的字符串字节可能不同，影响 equals() 或哈希计算。

• CI/CD 中务必统一 Git 的 core.autocrlf 设置（推荐 input）
• 测试时别只用 System.lineSeparator() 拼接断言，要直接比对原始字节或用 String.lines().count() 验证行数
• 若需强制 LF，老办法仍是 str.replace("\r\n", "\n").replace("\r", "\n") —— 文本块没解决这个问题

文本块能嵌套吗？不能，但可以用 + 拼接或转义

文本块不支持嵌套，""" 出现三次就会被当作结束标记。想在内容里显示 """，只有两个办法：拼接，或用 \ 转义中间那个引号。

比如要生成 JSON 片段 {"name":"""Alice"""}：

String json = """
    {"name":"\\"""Alice\\"""}
    """;

或者更清晰的拼接写法：

String json = """
    {"name":"\"""""" + "Alice" + "\"""\""}
    """;

• 转义写法易读性差，尤其含多个 """ 时容易数错反斜杠
• 拼接方式虽多一次 +，但逻辑清晰，JVM 会在编译期优化成常量字符串
• 注意：文本块内部不支持表达式插值（不像 Kotlin 的 ${x}），所有动态内容必须靠 String.format() 或 + 拼接

文本块省事，但缩进逻辑和换行行为得亲手试一遍才信得过——尤其当字符串要进配置、SQL 或正则时，多一个空格、少一个换行都可能让运行时崩得莫名其妙。

今天带大家了解了的相关知识，希望对你有所帮助；关于文章的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~