当前位置：首页 > news >正文

你还在用 `+ “\\n“` 拼多行字符串吗？Java 的文本块都已经能让代码“像人写的”了！

news 2026/6/10 20:24:15

👋你好，欢迎来到我的博客！我是【菜鸟不学编程】
我是一个正在奋斗中的职场码农，步入职场多年，正在从“小码农”慢慢成长为有深度、有思考的技术人。在这条不断进阶的路上，我决定记录下自己的学习与成长过程，也希望通过博客结识更多志同道合的朋友。

🛠️ 主要方向包括 Java 基础、Spring 全家桶、数据库优化、项目实战等，也会分享一些踩坑经历与面试复盘，希望能为还在迷茫中的你提供一些参考。
💡 我相信：写作是一种思考的过程，分享是一种进步的方式。

如果你和我一样热爱技术、热爱成长，欢迎关注我，一起交流进步！

全文目录：

- I. 文本块语法：`""" 多行字符串 """`
- - 1）基本用法：三引号包起来
  - 2）起始行的“小规矩”
- II. 转义与缩进：自动处理空格（但别误会它“会读心”）
- - 1）缩进裁剪：它会找“最小公共缩进”
  - 2）想控制末尾换行？用 `\`（行尾反斜杠）
  - 3）需要在行尾保留空格？用 `\s`
- III. 格式化：`String::formatted` 方法（终于不用满屏 `+` 了）
- - 1）示例：生成一段 JSON
  - 2）小心“格式化注入”（别在高风险输入上裸奔）
- IV. 与传统字符串比较：可读性提升（不是“语法糖”，是“维护成本下降”）
- - 1）传统写法：拼接 + 转义 + 换行符
  - 2）文本块写法：结构就是结构
- V. HTML/JSON 应用：嵌入多行文本（最常见、最值得）
- - 1）SQL：别再在字符串里“逃逸人生”
  - 2）JSON：结构清晰，编辑成本低
  - 3）HTML：用于邮件模板/报表渲染
- VI. 项目：生成报告的文本块使用（一个“像工程”的小报表）
- - 1）定义一个简单的数据模型
  - 2）用文本块生成 Markdown 报告
  - 3）用文本块生成 HTML 报告（简单版）
  - 4）跑一个 demo（生成两份报告字符串）
- 小结：文本块不是“更短”，是“更不容易写错”
- 📝 写在最后

I. 文本块语法：`""" 多行字符串 """`

文本块最直观的优点就是：多行就是多行，不需要你手动写换行符。

1）基本用法：三引号包起来

Stringsql=""" SELECT id, name, created_at FROM users WHERE status = 'ACTIVE' ORDER BY created_at DESC """;

你看，字符串里有换行、缩进，代码也有换行、缩进——读起来像你脑子里想的样子。

2）起始行的“小规矩”

开始的"""后面通常换行（更清晰）
结束的"""所在位置会影响缩进裁剪（下一节讲）

II. 转义与缩进：自动处理空格（但别误会它“会读心”）

文本块有两个“真香点”：

自动处理缩进（indentation stripping）
减少转义需求

1）缩进裁剪：它会找“最小公共缩进”

看这个例子：

Strings=""" line1 line2 line3 """;System.out.println(s);

输出会保留相对缩进，但会裁掉“所有行共有的最小缩进”。
这意味着：你可以为了让代码排版好看而缩进，但最终字符串不会多出那些“为了对齐而产生的多余空格”。

重点：它保留相对缩进，不是把所有行都左对齐。

2）想控制末尾换行？用`\`（行尾反斜杠）

文本块默认会包含结尾换行（多数时候是你想要的）。
但如果你不想要最后那个换行：

StringnoTrailingNewline=""" hello world\""";

这个\会把最后的换行“吃掉”。
（第一次见的人一般会“啊？”一下，正常😄）

3）需要在行尾保留空格？用`\s`

有时候你想保留行尾空格（例如 Markdown 对齐、某些固定格式输出），文本块会帮你裁剪得太“干净”。这时你可以显式保留：

StringkeepSpace=""" a\s b\s """;

III. 格式化：`String::formatted`方法（终于不用满屏`+`了）

文本块和formatted()简直是天生一对：
你写一个模板，再把变量填进去，代码立刻从“拼接现场”变成“模板渲染”。

1）示例：生成一段 JSON

Stringname="Ophelia";intscore=97;Stringjson=""" { "name": "%s", "score": %d, "passed": %b } """.formatted(name,score,score>=60);System.out.println(json);

你会发现它比String.format(...)更顺手的地方在于：
模板字符串就在那儿，你一眼能看到结构，不用在参数列表里找半天。

当然，它底层还是走 format 语义，格式符%s/%d/%f那些规则都一样。

2）小心“格式化注入”（别在高风险输入上裸奔）

如果用户输入里可能包含%，在某些场景会造成格式化异常或输出混乱。
高风险场景请先转义或用更安全的模板渲染方式（尤其是日志/SQL/命令行这类）。

IV. 与传统字符串比较：可读性提升（不是“语法糖”，是“维护成本下降”）

我们来对比一下经典的“字符串地狱”。

1）传统写法：拼接 + 转义 + 换行符

Stringhtml="<html>\n"+" <body>\n"+" <h1>Report</h1>\n"+" </body>\n"+"</html>\n";

读起来像在数\n，写起来像在搬砖，还容易漏掉引号。

2）文本块写法：结构就是结构

Stringhtml=""" <html> <body> <h1>Report</h1> </body> </html> """;

维护体验差别非常大：

改一行 HTML，不会牵动 10 行拼接
diff 更干净，代码审查也更容易
少了很多“我是不是漏了个+”的低级错误

所以它不是仅仅“少写几个字符”，而是：降低未来维护者（包括你自己）脑内负担。

V. HTML/JSON 应用：嵌入多行文本（最常见、最值得）

文本块最舒服的用途就是放这些“结构化文本”：

1）SQL：别再在字符串里“逃逸人生”

Stringsql=""" SELECT id, name FROM users WHERE age >= %d ORDER BY name """.formatted(18);

2）JSON：结构清晰，编辑成本低

Stringpayload=""" { "event": "login", "userId": "%s", "timestamp": "%s" } """.formatted("u-42",java.time.Instant.now());

3）HTML：用于邮件模板/报表渲染

Stringpage=""" <div class="card"> <h2>%s</h2> <p>%s</p> </div> """.formatted("Weekly Report","All systems nominal.");

但我得提醒一句：如果你在做复杂 HTML 模板，文本块只是“字符串更好写”，它不是模板引擎。复杂场景建议用真正的模板方案（比如 Thymeleaf/Freemarker 等），别硬撑🙂。

VI. 项目：生成报告的文本块使用（一个“像工程”的小报表）

我们做个小项目：生成一份“运行报告”，同时输出Markdown和HTML两种格式。
为什么是这两种？因为它们最能体现文本块的价值：结构化、多行、可读。

1）定义一个简单的数据模型

importjava.time.Instant;importjava.util.List;publicrecordReport(Stringtitle,InstantgeneratedAt,List<Item>items){publicrecordItem(Stringname,Stringstatus,longlatencyMs){}}

2）用文本块生成 Markdown 报告

importjava.util.stream.Collectors;publicclassReportRenderer{publicstaticStringtoMarkdown(Reportr){Stringrows=r.items().stream().map(i->"| %s | %s | %dms |".formatted(i.name(),i.status(),i.latencyMs())).collect(Collectors.joining("\n"));return""" # %s - Generated At: %s - Total Items: %d | Name | Status | Latency | | ---|--------|---------| %s > Note: Latency is measured at client side. """.formatted(r.title(),r.generatedAt(),r.items().size(),rows);}}

你会发现：Markdown 的“表格块”在文本块里写起来特别顺，不会被\n折磨。

3）用文本块生成 HTML 报告（简单版）

importjava.util.stream.Collectors;publicclassHtmlReportRenderer{publicstaticStringtoHtml(Reportr){Stringrows=r.items().stream().map(i->""" <tr> <td>%s</td> <td>%s</td> <td>%d ms</td> </tr> """.formatted(escape(i.name()),escape(i.status()),i.latencyMs())).collect(Collectors.joining("\n"));return""" <!doctype html> <html lang="en"> <head> <meta charset="utf-8"/> <title>%s</title> <style> body { font-family: Arial, sans-serif; margin: 24px; } table { border-collapse: collapse; width: 100%%; } th, td { border: 1px solid #ddd; padding: 8px; } th { text-align: left; } </style> </head> <body> <h1>%s</h1> <p><b>Generated At:</b> %s</p> <table> <thead> <tr><th>Name</th><th>Status</th><th>Latency</th></tr> </thead> <tbody> %s </tbody> </table> </body> </html> """.formatted(escape(r.title()),escape(r.title()),r.generatedAt(),rows);}privatestaticStringescape(Strings){if(s==null)return"";returns.replace("&","&amp;").replace("<","&lt;").replace(">","&gt;").replace("\"","&quot;");}}

注意一个小细节：CSS 里有100%，在formatted()模板中%是格式符起始，所以要写100%%。
这类“百分号小坑”在模板里很常见，别踩一次才记住😅。

4）跑一个 demo（生成两份报告字符串）

importjava.time.Instant;importjava.util.List;publicclassReportDemo{publicstaticvoidmain(String[]args){Reportreport=newReport("Service Health Report",Instant.now(),List.of(newReport.Item("UserService","OK",23),newReport.Item("OrderService","WARN",187),newReport.Item("PaymentService","FAIL",0)));Stringmd=ReportRenderer.toMarkdown(report);Stringhtml=HtmlReportRenderer.toHtml(report);System.out.println(md);System.out.println("------");System.out.println(html.substring(0,Math.min(400,html.length()))+"...");}}