Java String.lines 怎样统一处理 CRLF 和 LF

Java 文本来自 Windows、Linux 或接口载荷时，换行符可能混在一起：Windows 常见 CRLF，Unix-like 环境常见 LF，也可能遇到单独的 CR。如果直接用固定字符串切分，边界很容易被写死。Java 11 起可以用 String.lines() 统一读取这三种行终止符，再决定是否把结果重新拼成 LF。

官方资料：https://docs.oracle.com/en/java/javase/25/docs/api/java.base/java/lang/String.html#lines()

核心做法：用 text.lines() 读取逻辑行；它识别 \n、\r 和 \r\n，返回的行不含终止符。需要固定输出格式时，再用 String.join("\n", lines) 生成 LF 文本。

String.lines() 到底识别哪些换行

lines() 返回的是 Stream。官方定义的行终止符只有三种：换行 U+000A、回车 U+000D，以及紧邻的回车加换行 U+000D U+000A。终止符用于分隔行，但不会出现在返回的行内容中。

String text = "alpha\r\nbeta\ngamma\rdelta";

// lines() 统一识别三种行终止符，返回的每个元素都不包含终止符。
List lines = text.lines().toList();

// 这里的列表内容依次是 alpha、beta、gamma、delta。
System.out.println(lines);

这段代码的关键不是把 CRLF 替换成 LF，而是先把“行”从“终止符表示”中分离出来。后续业务只处理行内容，就不会因为输入来自不同系统而分出多条解析路径。

用流读取时要注意惰性和消费方式

lines() 返回流，适合逐行过滤、映射或计数。流只能消费一次；如果后面还要把行重新拼接，就先收集到列表，或者在同一条流链中完成最终操作。不要为了判断换行类型而先用 split("\\r?\\n") 再补规则，因为这种写法没有覆盖单独的 CR，也容易让空行与末尾空字符串的语义变得不直观。

String text = "  first\r\n\r\nsecond\nthird\r";

// 只保留非空行；strip() 处理行两端空白，但不会改变换行解析规则。
List nonBlankLines = text.lines()
        .map(String::strip)
        .filter(line -> !line.isEmpty())
        .toList();

// 输出业务层真正需要的逻辑行，而不是把 CRLF/LF/CR 带到下游。
nonBlankLines.forEach(System.out::println);

如果空行本身有业务意义，例如配置文件中的段落分隔，就不要直接 filter。lines() 会保留由终止符分隔出的空行，只是它不会把文本末尾的终止符再解释成一个额外的空行。

空字符串和末尾换行不要误判

官方语义有两个经常影响测试用例的边界。第一，空字符串调用 lines() 后是零行；第二，如果文本最后一个字符是行终止符，终止符后没有新的字符，因此不会返回一个额外的空字符串行。下面的表可以作为解析规则的速查：

因此，业务若要求“文件必须以换行结尾”，不能用返回行数反推这个属性。应在调用 lines() 前单独记录原文本是否以 \n 或 \r 结束；行拆分负责读取内容，末尾换行属于原始格式元数据。

需要统一输出时怎样固定为 LF

读取和写入是两个动作。lines() 只把输入转换为逻辑行，并不会修改原字符串；如果要产生跨平台稳定的文本，可以用 LF 作为明确分隔符重新拼接。这样做时要先决定是否保留原文本的末尾换行。

String text = "alpha\r\nbeta\rgamma";

// 先把输入换行转换成逻辑行，再明确使用 LF 作为输出分隔符。
List lines = text.lines().toList();
String normalized = String.join("\n", lines);

// normalized 的内容统一使用 LF，但不会自动追加末尾 LF。
System.out.print(normalized);

如果规范要求最终文本必须以 LF 结束，可以把规则写出来，而不是依赖运行平台：

String normalizedWithFinalLf = normalized.endsWith("\n")
        ? normalized
        : normalized + "\n"; // 明确补一个 LF，避免依赖平台默认换行。

不过这段补尾换行的代码只适合已经确定“输出必须以 LF 结尾”的协议或文件格式。若原始文本为空，是否输出一个 LF 也应由协议决定，不能因为 lines() 返回零行就默认生成一行空内容。

生产代码中的处理清单

• 运行环境至少是 Java 11，因为 String.lines() 自 Java 11 提供。
• 把输入拆成逻辑行后再做业务判断，不要把 \r 或 \n 留给下游重复解析。
• 需要保留空行时，不要无条件过滤空字符串；需要判断文件末尾换行时，另行保存原始末尾状态。
• 需要稳定跨平台输出时，显式使用 String.join("\n", lines)；不要把平台默认换行当成协议格式。
• 大文本不要为了简单而长期保存多份列表；可以直接消费 Stream，只有需要重复使用或重新拼接时才收集。

常见追问

String.lines() 会返回换行符吗？

不会。返回的每个字符串只包含行内容，CRLF、LF 或 CR 都只是分隔依据。

为什么不用 split("\\n")？

固定按 LF 切分无法自然处理单独的 CR，也容易把尾部空字符串规则和业务需求混在一起。混合来源文本优先使用 lines()。

用 lines() 后会自动把文本改成 LF 吗？

不会。它返回一个读取视角的流；只有在重新用 LF 连接并写回文件或响应时，才真正产生 LF 格式的输出。

总结一下：String.lines() 负责把 CRLF、LF、CR 统一解释为逻辑行，String.join("\n", lines) 负责在输出阶段明确采用 LF。把这两个职责分开，既能正确读取混合换行，也能避免把末尾换行、空行和平台默认格式混成一个问题。