Java String.splitWithDelimiters 怎样保留文本中的分隔符

Java 的 String.split() 会把匹配到的分隔符吃掉。如果后续逻辑还要判断原始分隔符、重建标记或区分不同类型的切分，就不要再从结果文本里反推。Java 21 起可以直接使用 String.splitWithDelimiters(regex, limit)，它会把文本片段和匹配到的分隔符按出现顺序交替放进结果数组。

官方文档：https://docs.oracle.com/en/java/javase/25/docs/api/java.base/java/lang/String.html#splitWithDelimiters(java.lang.String,int)

最小可用选择是：需要保留分隔符时使用 splitWithDelimiters；通常先用负数 limit 保留完整结果，再根据业务决定是否截断。

先看触发信号：split 后分隔符消失

假设订单文本用一个或多个冒号分隔状态：订单:已支付:::待发货。普通 split 只能得到文本片段，原来的单冒号和三冒号都不在结果里；如果冒号本身代表状态转换或协议标记，这个信息就丢了。

值班时先确认三件事：运行时是否为 Java 21 及以上；分隔符是否应该按正则匹配；调用方是否需要保留末尾空片段。三项都满足时，直接切换到 splitWithDelimiters，不要在业务层拼接猜测规则。

最小处理路径：让分隔符回到结果数组

下面的例子使用 :+ 匹配连续冒号，并用 -1 保留完整结果。返回数组从文本片段开始，之后依次是分隔符、文本片段、分隔符，最后一个元素是末尾文本。

import java.util.Arrays;

public class SplitWithDelimitersDemo {
    public static void main(String[] args) {
        String input = "订单:已支付:::待发货";

        // 使用正则匹配一个或多个冒号，并用 -1 保留完整结果。
        String[] parts = input.splitWithDelimiters(":+", -1);

        // 结果会按文本片段、分隔符、文本片段交替排列。
        System.out.println(Arrays.toString(parts));
    }
}

这个调用的关键不是“多了一个 API”，而是返回数组有了稳定的交替结构：文本片段位于偶数下标，分隔符位于奇数下标。只要正则不会匹配空字符串，调用方就可以按这个结构消费。

按 limit 快速判断结果形态

limit 不是数组长度的简单硬上限，它控制正则最多应用多少次，并进一步影响结果数组长度。由于每次匹配通常会带来一个文本片段和一个分隔符，正数 limit 的数组长度上限是 2 × limit - 1。

String input = "a::b:";

// 正数 limit：限制匹配次数，最后一项接收剩余文本。
String[] firstTwo = input.splitWithDelimiters(":+", 2);

// 0：完整匹配后丢弃尾部空字符串。
String[] withoutTrailingEmpty = input.splitWithDelimiters(":+", 0);

// 负数：完整匹配并保留尾部空字符串，适合位置敏感的数据。
String[] keepAll = input.splitWithDelimiters(":+", -1);

处理结果数组：不要把下标规则写死成业务含义

交替数组适合做轻量解析，但下游仍应根据数组内容和协议规则判断，而不是把“奇数下标一定是某个业务状态”写死。尤其当正则允许连续分隔符、输入以分隔符开头或结尾时，空片段也可能是有意义的数据。

import java.util.ArrayList;
import java.util.List;

static List delimiters(String input, String regex) {
    String[] parts = input.splitWithDelimiters(regex, -1);
    List result = new ArrayList();

    // 奇数下标对应匹配到的分隔符；偶数下标是文本片段。
    for (int i = 1; i 

如果业务要保留空片段，就应当坚持使用负数 limit。如果只要分隔符而不关心文本片段，可以在一次切分后抽取奇数下标；不要再对原字符串执行第二次正则扫描，否则两次规则很容易发生漂移。

回滚路径：Java 21 以下怎样处理

splitWithDelimiters 的 API 起点是 Java 21。低版本运行时不能直接调用它，回滚时可用 Pattern 和 Matcher 按匹配区间手动收集片段与分隔符。这个回退示例只覆盖“保留全部匹配”的基本路径，不承诺完全复制 limit 的全部语义。

import java.util.ArrayList;
import java.util.List;
import java.util.regex.Matcher;
import java.util.regex.Pattern;

static List splitKeepingDelimiters(String input, String regex) {
    Matcher matcher = Pattern.compile(regex).matcher(input);
    List parts = new ArrayList();
    int cursor = 0;

    // 每次匹配前先收集文本片段，再收集原样分隔符。
    while (matcher.find()) {
        parts.add(input.substring(cursor, matcher.start()));
        parts.add(matcher.group());
        cursor = matcher.end();
    }

    // 最后一个分隔符之后的文本也要保留，包含空字符串的情况。
    parts.add(input.substring(cursor));
    return parts;
}

回滚时应把兼容性写进发布清单：编译目标、运行时版本、正则规则和空片段策略必须一起确认。升级到 Java 21 以后，再将这段手动区间处理替换回标准 API。

告警确认与复盘清单

1. 先看运行时版本，Java 21 以下不要编译 splitWithDelimiters 调用。
2. 确认正则是否会匹配连续分隔符、空宽度或输入首尾。
3. 对位置敏感的数据优先使用负数 limit，避免尾部空字符串被丢弃。
4. 记录一个真实输入、正则、limit 和期望数组，作为回归样例。
5. 若结果数量异常，先检查 limit 和正则，再检查下游是否误把奇偶下标当成固定业务字段。

常见问题

splitWithDelimiters 和 split 最大的区别是什么？

split 只返回分隔后的文本片段，splitWithDelimiters 还会把匹配到的分隔符放回结果数组，且两者都受正则和 limit 影响。

为什么结果数组里会出现空字符串？

输入首尾有分隔符、连续分隔符或使用负数 limit 保留完整结果时，空片段可能是原始数据位置的一部分。是否删除应该由协议决定。

limit 应该从哪个值开始试？

需要完整结构时从 -1 开始；只取前面几段时用正数；只有在确认尾部空项无意义时才使用 0。