Java String.stripIndent 如何清理多行文本缩进：文本块与空白边界

把 SQL、JSON 片段或邮件模板写进 Java 文本块（text block）后，最容易遇到的不是语法错误，而是结果开头多出一段代码缩进。String.stripIndent() 解决的正是这个问题：它按每行的共同缩进清理文本，同时保留行与行之间的相对层级。真实模板常见的 SELECT / FROM / WHERE 三段也适合拿来观察这个变化。真正需要留意的是空行、Tab 和字符串末尾换行，它们决定了你看到的结果是否和编辑器里的样子一致。

只想去掉文本块带进来的公共左缩进，用 stripIndent()；还要统一增加或减少每行缩进、并保留新的行尾时，再考虑 indent(int)。

文本块为什么会带着代码缩进进入结果

Java 文本块的结束分隔符位置会影响编译器判断的内容边界。下面的示例把模板放在方法体里，视觉上为了可读性向右缩进；如果直接调用 stripIndent() 前先打印原始字符串，就能看到每一行的前导空白并不相同。

String raw = """
        SELECT id, name
          FROM users
         WHERE status = 'ACTIVE'
        """;

System.out.println(raw.replace(" ", "·"));

这里有两层缩进：第一层来自 Java 源码的排版，第二层是 SQL 自己需要表达的相对关系。处理目标不是把所有空格删除，而是找到非空行的公共前缀，再保留 FROM 和 WHERE 相对于 SELECT 的差异。

stripIndent 与 indent：两个候选方案的边界

stripIndent 负责把公共前缀移走

stripIndent() 会返回一个去掉共同前导空白的新字符串，也就是去掉各行共享的“共同前缀”。把结果逐字符显示，适合排查“看起来对齐、实际多了空格”的问题：

String cleaned = raw.stripIndent();
System.out.println(cleaned.replace(" ", "·"));
System.out.println("first=" + (int) cleaned.charAt(0));

在这个例子里，SELECT、FROM、WHERE 会从同一个公共起点开始，但 FROM 前的额外空格仍然存在。这个特性很适合保留 SQL、配置文件或 Markdown 的内部层级。

indent 适合做统一的二次排版

indent(2) 会给每一行增加两个空格，并确保字符串以换行结尾；传入负数时，它会尝试从每一行移除相应数量的空白。它的目标是重新排版，不是单纯识别文本块的公共缩进。

String indented = cleaned.indent(2);
System.out.println(indented.replace(" ", "·"));

所以，候选方案的分界很清楚：输入是“编辑器缩进污染”，先用 stripIndent()；输入已经干净、只是要嵌入另一段模板，才用 indent(int) 做二次排版。

空行、Tab 和末尾换行要单独验收

最容易误判的是空白边界。控制台会把空格、Tab 和换行显示得很相似，建议用字符编号做一次小实验：

static void show(String label, String value) {
    System.out.println(label + " length=" + value.length());
    for (int i = 0; i 

length 用来发现末尾是否多了一个换行；[SP]、[TAB] 和 [LF] 则把不可见字符变成可检查的证据。不要只根据 IDE 的预览判断快照测试是否会通过。

• 空行：不要用肉眼估计它是否参与了公共缩进判断，直接观察清理前后的字符序列。
• Tab：团队若同时使用 Tab 与空格，同一份模板在不同编辑器里的视觉宽度可能不同，先统一格式化规则。
• 末尾换行：需要做精确字符串比较时，明确约定是否保留 LF；如果只关心内容，可在断言前显式处理。

什么时候不该用 stripIndent

如果文本中的前导空格本身就是数据，例如 Markdown 代码围栏、Python 代码或 YAML 层级，就不能把“共同缩进”当成噪声。此时应保留原文，或者只对确定的包装层做一次 indent(-n)，并用字符级测试锁住边界。

同样，SQL 参数绑定、JSON 序列化和 HTML 转义不应靠字符串缩进方法完成。stripIndent() 只改变空白，不会校验语法、替换变量，也不会让拼接出来的 SQL 变得安全。

用一张决策表选方法

相关问题

stripIndent 会删除所有行首空格吗？

不会。它移除共同的前导缩进，行之间多出来的相对空格会保留。

indent(0) 能替代 stripIndent 吗？

不能把两者当作同义方法。indent 还涉及每行补空格和末尾换行，是否等价要用字符序列验证。

为什么控制台看不出多了一个换行？

因为 println 自己还会追加换行。要判断真实结果，请打印 length 或逐字符显示 [LF]。

小结

把文本块当成可验证的数据，而不是只看编辑器里的排版。先用 stripIndent() 清掉包装层公共缩进，再根据是否需要二次排版决定要不要调用 indent(int)；涉及空行、Tab 或末尾换行时，字符级输出比肉眼更可靠。