登录
首页 >  文章 >  java教程

Java15多行字符串定义方法

时间:2026-04-23 21:29:13 460浏览 收藏

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

如何在Java中定义多行字符串_Java15文本块(Text Blocks)语法

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 = """
    <div>
      <p>Hello</p>
    </div>
    """;

三行非空内容的前导空格数分别是 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学习网公众号,一起学习编程~

资料下载
相关阅读
更多>
最新阅读
更多>
课程推荐
更多>