Java 21 Pattern.splitWithDelimiters 怎么保留分隔符：空字段、尾部分隔与兼容回退

处理一行带分隔符的配置或日志时，普通的 split() 往往把真正有用的边界吃掉：你能拿到字段，却不知道字段之间原来是逗号、箭头还是换行标记。Java 21 的 Pattern.splitWithDelimiters() 正好补上这个缺口，它会按“文本、分隔符、文本、分隔符、文本”的顺序返回结果，适合需要保留原始格式或再次拼装的场景。

先看结果：普通 split 为什么不够用

假设日志格式是 user=42|role=editor|state=ready，竖线既是字段边界，也是后续重建原文时不可丢失的符号。传统写法只能得到三个字段：

String line = "user=42|role=editor|state=ready";
String[] parts = line.split("\\|");
System.out.println(Arrays.toString(parts));
// [user=42, role=editor, state=ready]

如果业务只做读取，这没有问题；但做格式迁移、差异展示、日志高亮时，还需要知道每个字段后面原来跟着什么。Java 21 可以直接写：

Pattern separator = Pattern.compile("\\|");
String[] tokens = separator.splitWithDelimiters(line, 0);
System.out.println(Arrays.toString(tokens));
// [user=42, |, role=editor, |, state=ready]

把 limit 讲清：匹配次数和尾字段是两件事

limit 决定正则最多应用多少次。正数会在达到次数后把剩余内容整体放进最后一个元素；零值会尽可能切分，并丢弃结果末尾的空字符串；负数同样尽可能切分，但会保留尾部空字符串。

有一个容易忽略的边界：每次匹配都会带来一个分隔符元素，因此正数 limit 下数组长度并不等于字段数量。需要限制总段数时，先用小样例打印数组，再确定解析器的步长。

空字段和连续分隔符怎么解析

输入 user=42||state=ready| 包含连续分隔符和末尾分隔符。推荐把返回数组按两个元素一组读取：偶数下标是字段，奇数下标是分隔符。最后如果还有一个字段，它就是没有后续分隔符的尾字段。

static List fields(String input, Pattern separator) {
    String[] tokens = separator.splitWithDelimiters(input, -1);
    List values = new ArrayList();
    for (int i = 0; i 

这里使用负数 limit 是有意的：空字段属于输入事实，不能因为默认规则被静默删掉。若配置格式不允许连续分隔符，再在解析完成后明确报错，而不是把空项当成不存在。

Java 17 运行环境的兼容回退

该 API 的 Since 标记是 21。项目仍运行在 Java 17 时，不要直接反射调用一个不存在的方法；可以用 Matcher.find() 扫描分隔符位置，按同样的交替规则构造数组。

static List splitWithSeparator(String input, Pattern separator) {
    Matcher matcher = separator.matcher(input);
    List result = new ArrayList();
    int cursor = 0;
    while (matcher.find()) {
        result.add(input.substring(cursor, matcher.start()));
        result.add(matcher.group());
        cursor = matcher.end();
    }
    result.add(input.substring(cursor));
    return result;
}

回退实现的验收重点不是“代码看起来像不像官方方法”，而是相同输入在两条路径上产生相同的文本、分隔符、空字段和尾字段序列。把样例固定在测试里，升级到 Java 21 后再切换到标准 API。

上线前的检查清单

• 运行时版本是否真的为 Java 21 或更高，不能只看编译器配置。
• 正则是否会匹配零宽内容；零宽匹配可能让边界数量与预期不同。
• 需要保留尾部空字段时是否使用负数 limit。
• 解析器是否把字段、分隔符和尾字段分别验收，而不是只断言数组长度。
• Java 17 回退实现是否覆盖空输入、连续分隔符、首分隔符和末尾分隔符。

常见问题

splitWithDelimiters 返回的分隔符会和字段合并吗？

不会。返回数组按文本、分隔符交替排列，分隔符仍是独立元素。

limit 设为 0 会保留末尾空字段吗？

不会。零值会丢弃结果末尾由切分产生的空字符串；格式校验通常应使用负数。

Java 17 能直接调用这个方法吗？

不能。它从 Java 21 起提供，Java 17 应使用基于 Matcher.find() 的回退或先升级运行时。

什么时候仍然用普通 split？

只需要字段值、不需要重建原格式，也不关心尾部空字段时，普通 split() 更简单。

这个 API 的价值不在于少写几行代码，而在于切分后仍保留输入的边界信息。先用正数、零值和负数三个样例确认业务语义，再决定使用 Java 21 标准方法还是 Java 17 回退实现，后续维护会更稳。