快捷導(dǎo)航

Java17新特性之Text Blocks文本塊的使用

更新時間：2025年10月01日 11:14:58 作者：自由的瘋

Java 17引入了Text Blocks（文本塊）特性,這是Java語言中一種新的字符串表示方式,本文就來詳細(xì)的介紹一下文本塊的使用,感興趣的可以了解一下

Text Blocks 的基本用法

Text Blocks 使用三個雙引號 ??"""?? 來界定字符串內(nèi)容。與普通字符串不同，Text Blocks 可以跨多行，并且保留字符串中的換行符和縮進(jìn)。

示例：

String json = """
    {
        "name": "Alice",
        "age": 25,
        "city": "New York"
    }
    """;
System.out.println(json);

輸出：

{
    "name": "Alice",
    "age": 25,
    "city": "New York"
}

Text Blocks 的特點

自動處理換行符： Text Blocks 會保留字符串中的換行符，無需手動插入 ??\n??。

String text = """
    Line 1
    Line 2
    Line 3
    """;
System.out.println(text);

輸出：

Line 1
Line 2
Line 3

減少轉(zhuǎn)義字符：在普通字符串中，雙引號需要使用反斜杠 ??\?? 轉(zhuǎn)義，而 Text Blocks 不需要。

// 普通字符串
String html = "<html>\n" +
              "    <body>\n" +
              "        <p>Hello, World!</p>\n" +
              "    </body>\n" +
              "</html>";

// 使用 Text Blocks
String htmlBlock = """
    <html>
        <body>
            <p>Hello, World!</p>
        </body>
    </html>
    """;

自動去除縮進(jìn)： Text Blocks 會根據(jù)最左邊非空字符的位置自動調(diào)整縮進(jìn)。這使得代碼格式化更靈活。

String query = """
        SELECT *
        FROM users
        WHERE id = 1
        """;
System.out.println(query);

輸出：

SELECT *
FROM users
WHERE id = 1

支持表達(dá)式嵌入：和普通字符串一樣，Text Blocks 支持嵌入表達(dá)式，使用 ??%d?? 格式。

int age = 25;
String message = """
    Hello, my name is Alice.
    I am %d years old.
    """.formatted(age);
System.out.println(message);

輸出：

Hello, my name is Alice.
I am 25 years old.

注意事項

結(jié)束符必須單獨一行：結(jié)束的三引號 ??"""?? 必須獨占一行，不能與內(nèi)容在同一行。錯誤示例：

String text = """
    This is a text block""";

正確示例：

String text = """
    This is a text block
    """;

保留換行符：如果你希望去掉某行的換行符，可以在該行末尾添加反斜杠 ??\??。

String text = """
    Line 1 \
    Line 2
    """;
System.out.println(text);

輸出：

Line 1 Line 2

縮進(jìn)規(guī)則： Text Blocks 會根據(jù)最左邊非空字符的位置自動調(diào)整縮進(jìn)，但你可以通過工具類（如 ??String.stripIndent()??? 或 ??String.translateEscapes()??）手動控制縮進(jìn)。