Java Pattern 怎样读取命名捕获组

Java 的 Pattern 命名捕获组写成 (?...)，匹配完成后直接通过 Matcher.group("name") 读取。实际使用时要先调用 find() 或 matches()，再读取组值；命名组没有参与本次匹配时返回 null，成功匹配但内容长度为零时返回空字符串。

官方资料：https://docs.oracle.com/en/java/

如果正则字段会随着需求增加而调整，命名组通常比记忆 group(1)、group(2) 更稳：先让模式定义业务名称，再让 Matcher 按名称返回字段。

• 定义：使用 (?...) 这样的语法给捕获组命名。
• 读取：匹配成功后调用 matcher.group("user")。
• 判空：未参与匹配是 null，匹配空内容是 ""。
• 定位：需要原文下标时使用 start("name") 和 end("name")。

命名捕获组到底解决什么问题

数字捕获组按左括号出现顺序编号，正则一旦插入新的括号，后续编号就可能整体变化。命名捕获组仍然有数字编号，但业务代码可以按稳定名称访问它，阅读时也能直接看出字段含义。

例如，日志行里同时有用户名和动作时，可以把两段文本分别命名为 user 与 action。这一步只负责定义捕获范围，真正读取仍然发生在 Matcher 完成一次成功匹配之后。

用 group(String) 读取命名组

最直接的写法是先编译模式，再创建 Matcher，最后在 find() 返回 true 后读取各个名称。下面的例子把 alice 和 login 绑定到两个命名组：

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

public class NamedGroupDemo {
    public static void main(String[] args) {
        // 用命名组标记用户名和动作，后续代码按名称取值。
        Pattern pattern = Pattern.compile("user=(?[a-zA-Z0-9_]+); action=(?[a-zA-Z]+)");
        Matcher matcher = pattern.matcher("user=alice; action=login");

        // 先确认本次 find 成功，再读取本次匹配保存的命名组。
        if (matcher.find()) {
            String user = matcher.group("user");
            String action = matcher.group("action");
            System.out.println(user + " -> " + action);
        }
    }
}

这里的关键不是 group 方法本身，而是读取时机。若还没有成功的匹配操作就直接调用 group("user")，Matcher 没有可供读取的上一轮结果，会抛出 IllegalStateException。如果名称根本没有在 Pattern 中定义，则会抛出 IllegalArgumentException。

可选命名组为什么会返回 null

命名组可以放在量词或可选分支中。一次匹配成功，并不代表每个组都一定参与了匹配：如果可选分支没有被走到，group("name") 返回 null。这表示“该组本轮没有捕获到输入”，不是“捕获到了一个长度为零的字符串”。

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

public class OptionalNamedGroupDemo {
    public static void main(String[] args) {
        // prefix 是可选组；没有前缀时，它不会参与本轮匹配。
        Pattern pattern = Pattern.compile("(?[A-Z]+-)?(?[a-z]+)");
        Matcher matcher = pattern.matcher("order");

        // 只有成功匹配后才读取组，并显式区分 null 与普通文本。
        if (matcher.matches()) {
            String prefix = matcher.group("prefix");
            String value = matcher.group("value");
            System.out.println(prefix == null ? "没有前缀" : prefix);
            System.out.println(value);
        }
    }
}

上例中 prefix 没有参与匹配，因此是 null；value 则捕获了 order。业务层如果需要把缺失字段转换成默认值，应在读取后处理，而不是直接对可能为 null 的结果调用方法。

另一种情况是组确实参与了匹配，但量词允许它匹配零个字符，例如 (?[A-Z]*)。此时返回的是空字符串 ""。这两个值都可能让界面看起来“没有内容”，但后续的默认值、统计和校验逻辑往往不同。

需要原文位置时按名称读取 start 和 end

除了字符串值，Matcher 还提供 start(String) 和 end(String)。它们返回命名组在原输入中的起止下标，end 是结束位置的后一个下标，适合做高亮、切片或错误位置提示。

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

public class NamedGroupPositionDemo {
    public static void main(String[] args) {
        // 用一个命名组捕获邮箱，位置信息将对应原始输入字符串。
        Pattern pattern = Pattern.compile("email=(?
[^;]+)");
        Matcher matcher = pattern.matcher("email=dev@example.com; status=ok");

        // 先完成 find，再按名称读取文本和半开区间 [start, end)。
        if (matcher.find()) {
            String address = matcher.group("address");
            int start = matcher.start("address");
            int end = matcher.end("address");
            System.out.println(address + " @ [" + start + ", " + end + ")");
        }
    }
}

如果某个可选组没有参与匹配，按名称调用 start 或 end 会得到 -1；如果组名不存在，则仍然是名称错误。读取文本和读取位置都应放在一次成功匹配的分支里。

命名组和数字组怎么选

我的取舍是：只要正则表达式的捕获值会进入后续业务对象，优先使用命名组；只用于控制优先级或重复次数的括号则写成非捕获组。这样既减少数字编号耦合，也避免无意增加捕获组总数。

常见问题

Java 命名捕获组的语法是什么？

使用 (?...)，其中名称首字符必须是字母，后续可使用字母或数字；读取时传入同一个名称，例如 matcher.group("name")。

为什么 group(String) 报 IllegalStateException？

通常是还没有调用成功的 find()、matches() 或 lookingAt()，或者最近一次匹配操作失败。把读取放到成功分支内即可。

命名组没有匹配到内容时一定是空字符串吗？

不一定。可选组没有参与匹配时返回 null；组参与匹配并成功捕获零长度文本时才返回空字符串。

可以同时用数字和名称读取同一个组吗？

可以。命名捕获组仍有数字编号，但业务代码更推荐按名称读取，因为正则前面增加捕获组时，数字编号更容易发生连锁变化。