Java String.indent 为什么会自动补换行符

调用 String.indent(int) 后发现字符串末尾多了一个换行符，通常不是 Java 偷偷修改了原文，而是这个方法的返回模型本来就包含“逐行处理后追加 LF”。它不是单纯在整段文本前面补空格：输入会按 String.lines() 的规则拆成逻辑行，每行调整缩进，再拼接一个 \n。

官方地址：https://docs.oracle.com/en/java/javase/25/docs/api/java.base/java/lang/String.html#indent(int)

没有末尾换行的非空字符串调用 indent 后，结果通常会以 \n 结束；输入已经以换行符结束时，不会因为“末尾空行”再凭空多出一行。

为什么 indent 会在末尾多出一个换行符

Java API 对 indent 的描述是：字符串在概念上先按 lines() 分成若干行，然后调整每一行，最后给每一行追加 LF（U+000A），再把它们连接起来。于是，"alpha" 虽然输入里没有行终止符，仍会被当作一行，结果就是 "alpha\n"。

这里的关键是“每个结果行都追加 LF”，不是“只在原字符串末尾补一个换行”。如果输入是多行文本，方法会对每一行分别执行相同规则；如果输入本身以换行结束，lines() 的定义不会把终止符后的空位置当成额外空行，因此结果仍保持对应的行数。

n 的正负决定每行怎样变化

indent 的参数表示每行开头要增加或删除多少个空白字符：

例如下面的代码把两行整体右移两格。注释里的可见换行写法只用于观察结果，不代表输出中真的包含两个字符反斜杠。

String source = "A\n  B";

// 正数表示每一行增加两个普通空格，返回值还会以 LF 结束。
String result = source.indent(2);

// 用可见标记观察换行，避免控制台把换行显示成空白。
System.out.println(result.replace("\n", "\\n\n"));

负数不是“删除 n 个空格”这么简单，而是从每行开头最多移除指定数量的空白字符。某一行只有一个空格却传入 -3 时，这个空格会被全部移除；Tab 也只按一个字符参与计数，不会按终端显示宽度计算。

几个输入边界会得到什么结果

排查字符串拼接问题时，可以把换行先替换成可见标记：

record Case(String name, String value) {}

// 只打印字符串的字符边界，便于看清末尾是否存在 LF。
static void show(Case item) {
    System.out.println(item.name() + " = "
        + item.value().replace("\r", "\\r").replace("\n", "\\n"));
}

// 无终止符的非空输入会得到一个末尾 LF。
show(new Case("plain", "A".indent(0)));       // A\n

// 已有 LF 的输入不会因为终止符后没有内容而再增加空行。
show(new Case("withLf", "A\n".indent(0)));   // A\n

// CRLF 会被 indent 规范化为 LF，n == 0 也不例外。
show(new Case("crlf", "A\r\nB".indent(0))); // A\nB\n

// 空字符串没有逻辑行，因此结果仍为空字符串。
show(new Case("empty", "".indent(2)));       // 空字符串

这几种边界说明了两个独立行为：缩进参数决定每行开头怎么改，行终止符规范化决定返回值怎样结束。即使传入 0，也不能把 indent(0) 当作“完全不改变原字符串”的方法。

不想要末尾换行时怎么处理

如果下游协议、签名计算或精确字符串比较要求没有末尾 LF，可以在明确知道业务规则的前提下移除最后一个换行符。不要直接对整个结果使用 trim()，因为它还会删除正文两端原本有意义的空白。

static String indentWithoutTrailingLf(String source, int amount) {
    // indent 负责逐行缩进和换行规范化。
    String indented = source.indent(amount);

    // 只移除 indent 产生的一个末尾 LF，不碰其他空白字符。
    if (indented.endsWith("\n")) {
        return indented.substring(0, indented.length() - 1);
    }
    return indented;
}

若场景需要保留 POSIX 文本或日志的末尾换行，就不要移除它；若要保留原始 CRLF，也不要用 indent 作为无损转换工具，因为它的职责包含把行终止符规范化为 LF。对于只想去除文本块公共缩进的场景，应另看 stripIndent()，不要把两个方法混用。

常见问题

为什么 n 等于 0 仍然改变了字符串？

因为 n 只控制缩进增删，indent 仍会按逻辑行重新拼接，并把行终止符统一成 LF。

Tab 会按照显示的四格或八格计算吗？

不会。API 规则按字符计数，Tab 作为一个空白字符处理，不会先展开为固定数量的空格。

记住一句话：indent 的结果是“每行完成缩进调整后带一个 LF 的拼接文本”。看到末尾换行时，先检查这是不是该方法的设计语义，再决定是否需要单独去掉最后一个字符。