Java Pattern named group 重复使用时如何读取

Java 的 named group（命名捕获组）“重复使用”通常混在三个问题里：同一个正则再次定义相同名称、一个捕获组被量词反复执行，以及用同一个名称读取多次 find() 的结果。它们的处理方式不同：同一正则里的名称必须唯一；量词只会更新同一个捕获槽；如果要拿到全部重复项，应让每次 find() 产生一条独立匹配。

先判断：是重复定义，还是重复匹配

下面这种写法看起来像是想用一个名称读取两个位置，但 Java Pattern 不允许同名捕获组：

String regex = "(?[a-z]+)-(?[a-z]+)";
// 同一个 Pattern 中重复声明 part，会在 compile 阶段抛出 PatternSyntaxException
Pattern pattern = Pattern.compile(regex);

正确做法取决于需求。如果两个位置本来就是两个字段，使用不同名称，例如 left 和 right；如果后半段只是分组而不需要单独读取，改成 (?:...) 非捕获组。命名组的名称只能对应一个捕获槽，不能把它当成一个可自动累积的数组。

group(String) 读取前，先完成一次匹配

命名组的读取入口是 Matcher.group(String)。它读取的是“上一次成功匹配”中的指定捕获值，因此不要在 matches() 或 find() 之前直接取值：

Pattern pattern = Pattern.compile("(?[a-z]+)-(?\\d+)");
Matcher matcher = pattern.matcher("alice-42");

// 先确认整段匹配成功，再读取命名组
if (matcher.matches()) {
    System.out.println(matcher.group("user")); // alice
    System.out.println(matcher.group("id"));   // 42
}

如果正则是 (?https)?://... 这类可选分支，匹配成功但该分支没有参与时，group("scheme") 返回 null；如果组确实匹配了空文本，返回的是空字符串。没有成功匹配就读取，会得到 IllegalStateException；名称不存在则是 IllegalArgumentException。

量词内的 named group 不会保留一组历史值

一个命名组放进 + 或 * 后，仍然只有一个捕获槽。每次重复成功时，新值会覆盖旧值：

Pattern pattern = Pattern.compile("(?[a-z])+");
Matcher matcher = pattern.matcher("abc");

// 量词让同一个捕获槽连续参与匹配，最后读取到 c
if (matcher.matches()) {
    System.out.println(matcher.group("letter")); // c
}

如果目标是读取完整的连续文本，应把量词放在命名组内部：(?[a-z]+)；如果目标是得到每一个单词，就不要依赖量词覆盖，而应把一次匹配定义成一个单词，再循环调用 find()。

用 find() 逐次读取全部重复项

当输入中有多个单词、多个编号或多段同类字段时，把“重复”放到 Matcher 的匹配次数上：

Pattern pattern = Pattern.compile("(?[a-zA-Z]+)");
Matcher matcher = pattern.matcher("go java redis");

// 每次 find 定位一个独立匹配，group(word) 读取当前这一项
while (matcher.find()) {
    String word = matcher.group("word");
    int start = matcher.start("word");
    int end = matcher.end("word");
    System.out.printf("%s [%d,%d)%n", word, start, end);
}

这种方式既能取得所有值，也能保留每项在原字符串中的区间。若正则包含可选命名组，要在循环里用 value == null 区分“该分支没有参加本次匹配”，不要把它误判为空文本。

常见问题

同一个 named group 能不能在两个分支里定义？

不能。Java Pattern 要求名称唯一；需要兼容两个分支时，通常让名称只出现一次，或分别使用不同名称后在 Java 代码中归一化。

为什么 group(name) 读到的不是第一个值？

如果组位于量词内部，后一次成功捕获会覆盖前一次。需要所有值时用 find()，而不是期待一个 group 调用返回列表。

group(name) 返回 null 是匹配失败吗？

不一定。整体匹配可以成功，只是可选组没有参与；真正没有成功匹配时，调用 group 会抛出状态异常。先判断匹配结果，再判断返回值。