Java 原生不提供 Matcher.expand() 方法，但可通过遍历命名/编号捕获组并安全替换 $1、${name} 等占位符，高效实现与 Go regexp.ExpandString 行为一致的模板展开功能。
java 原生不提供 `matcher.expand()` 方法，但可通过遍历命名/编号捕获组并安全替换 `$1`、`${name}` 等占位符，高效实现与 go `regexp.expandstring` 行为一致的模板展开功能。
在 Java 正则处理中，常需将匹配结果中的捕获组动态注入到模板字符串（如 $1、${group}），用于生成键名、日志格式或路由参数等。遗憾的是，Java 的 Matcher 类并未提供类似 Go regexp.ExpandString 或 Python re.sub 中的原生模板展开方法——replaceFirst() 和 appendReplacement() 会保留未匹配部分，无法仅对模板做纯占位符替换。
所幸，Java 19+ 已支持 Matcher.namedGroups()（返回 Map<string integer></string>），结合 groupCount() 和 group(int)，我们可完全避免手动解析正则语法，安全、通用地实现模板展开逻辑。
以下是推荐的实现方案：
import java.util.*;
import java.util.function.Function;
import java.util.regex.Matcher;
import java.util.regex.Pattern;
public static Function<String, AbstractMap.SimpleEntry<String, String>> process(String regex, String template) {
return input -> {
Matcher m = Pattern.compile(regex).matcher(input);
if (!m.find()) {
return null;
}
// 从模板出发，逐步替换所有占位符（注意：必须按长度/确定性顺序替换，避免冲突）
String result = template;
// 替换命名组：${name} → groupValue
for (Map.Entry<String, Integer> entry : m.namedGroups().entrySet()) {
String groupName = entry.getKey();
String groupValue = m.group(entry.getValue());
if (groupValue != null) {
// 使用 Pattern.quote 防止 groupName 中含正则元字符（如点、括号）
result = result.replaceAll("\$\{" + Pattern.quote(groupName) + "}",
Matcher.quoteReplacement(groupValue));
}
}
// 替换编号组：$1, $2...（注意：需转义 $ 并按数字降序替换，避免 $1 干扰 $12）
for (int i = m.groupCount(); i >= 1; i--) {
String groupValue = m.group(i);
if (groupValue != null) {
result = result.replaceAll("\$" + i, Matcher.quoteReplacement(groupValue));
}
}
return new AbstractMap.SimpleEntry<>(result, input);
};
}关键细节说明：
当用户要求为 Java 代码添加注释、修改注释、审查注释、整理注释格式，或要求按照代码注释规范处理 Java 文件时，使用本技能。本技能用于统一生成和维护 Java 类注释模板、按 Git 对比 release 判断版本号、补充每行代码上方中文块注释、调整注释空行规则，并保持 Java 文件 UTF-8 无 BOM 编码。典型触发场景包括：补充类注释、更新 @version、检查 @author 来源、整理行尾注释、把注释放到代码上一行、检查注释是否符合规范、构建前检查 Java 注释风格。
立即学习“Java免费学习笔记（深入）”；
- ✅ 安全替换：使用
Matcher.quoteReplacement()防止组值中含$、等特殊字符导致replaceAll异常； - ✅ 命名组兼容：利用
m.namedGroups()获取所有命名捕获组映射，无需硬编码或反射； - ✅ 编号组鲁棒性：从高编号向低编号替换（如先
$12后$1），避免$1错误覆盖$12中的前缀； - ✅ 空值防护：显式检查
m.group(i)是否为null（非必需组可能未匹配）； - ✅ 零依赖：纯标准库实现，无需第三方正则引擎或 AST 解析器。
使用示例：
String text = "https://www.myaddress.com?x=y&w=z&other=other&q=taco&temp=1";
var func1 = process("myaddress.com.*[?&]q=(\w+)", "$1");
var func2 = process("myaddress.com.*[?&]q=(?<query>\w+)&temp=(?<temp>\d+)", "q=${query},t=${temp}");
System.out.println(func1.apply(text).getKey()); // 输出：taco
System.out.println(func2.apply(text).getKey()); // 输出：q=taco,t=1⚠️ 注意事项：该方案要求 JDK ≥ 19（因
namedGroups()自 Java 19 引入）。若需兼容 JDK 8–17，可改用Pattern编译时预解析命名组（借助Pattern内部 API 或正则注释约定），但会牺牲简洁性。对于绝大多数现代项目，上述实现已是轻量、可靠且符合直觉的最佳实践。
