Java 中使用正则表达式实现多字符串批量替换

远山来客

发布时间：2026-10-15 | 2人浏览过

原创

在 Java 开发中，经常遇到需要根据预设的多组关键字进行文本替换的场景，例如模板引擎中的变量渲染或敏感信息脱敏。虽然 `String.replaceAll` 支持单次替换，但面对多条件映射时效率较低且代码冗长。本文将演示如何结合 `Pattern`（编译正则）与 `Matcher`（匹配器）构建高性能的多字符串批量替换方案，涵盖核心流程、特殊字符处理及关键正则元字符解析。

核心原理

Java 的正则操作主要分为两步：首先将正则表达式编译为不可变的 Pattern 对象以复用；其次创建与输入字符串绑定的 Matcher 对象执行查找与替换操作。Matcher 提供了丰富的 API，特别是 appendReplacement 和 appendTail 的组合使用，能够高效地构建替换后的新字符串。

多字符串批量替换实现

第1步：准备数据源与模板

定义一个 Map 存储待替换的关键字及其对应的目标值，同时准备好包含这些关键字占位符的原始模板字符串。

第2步：构建动态正则表达式

从 Map 中提取所有键名（关键字），利用 |（或运算符）连接它们，生成匹配任意一个关键字的正则字符串。注意需对占位符格式（如 ${...}）进行正确的转义处理。

第3步：执行匹配与替换

使用 Pattern.compile() 编译正则，获取 Matcher。循环调用 matcher.find() 定位每个匹配项，使用 matcher.appendReplacement(sb, replacement) 将匹配到的子串替换为 Map 中对应的值，最后用 appendTail() 追加剩余未匹配的尾部内容。

复制代码代码如下:

public static void main(String[] args) {
    // 被替换关键字的数据源
    Map tokens = new HashMap();
    tokens.put("cat", "Garfield");
    tokens.put("beverage", "coffee");

    // 匹配类似 velocity 规则的字符串
    String template = "${cat} really needs some ${be beverage}.";
    
    // 生成匹配模式的正则表达式，假设占位符格式为 ${key}
    String patternString = "\\$\\{" + StringUtils.join(tokens.keySet(), "|") + "\\}";

    Pattern pattern = Pattern.compile(patternString);
    Matcher matcher = pattern.matcher(template);

    StringBuffer sb = new StringBuffer();
    while(matcher.find()) {
        // 获取第一个分组的内容作为 key，从 Map 中取 value 进行替换
        matcher.appendReplacement(sb, tokens.get(matcher.group(1)));
    }
    matcher.appendTail(sb);

    // 输出: Garfield really needs some coffee.
    System.out.println(sb.toString());

    // 对于特殊含义字符如 "$"、"\"，在 replacement 中需使用 Matcher.quoteReplacement 消除特殊意义
    matcher.reset();
    System.out.println(matcher.replaceAll("$1")); 
    System.out.println(matcher.replaceAll(Matcher.quoteReplacement("$1")));
}

第4步：验证邮箱前缀提取示例

除替换外，该模式也常用于提取信息。以下示例演示如何验证邮箱格式并提取 @ 符号前的用户名：

复制代码代码如下:

// 获得邮箱的前缀名
String emailPattern = "^([a-z0-9_\\.\\-\\+]+)@([\\da-z\\.\\-]+)\\.([a-z\\.]{2,6})$";
pattern = Pattern.compile(emailPattern);
matcher = pattern.matcher("test@qq.com");

// 验证是否邮箱
System.out.println(matcher.find()); 
// 得到@符号前的邮箱名 out: test
// 注意：replaceAll 会替换整个匹配项，此处演示逻辑需谨慎，通常用于提取时配合 group() 使用
// 若仅想提取名字，直接使用 matcher.group(1) 更直观
System.out.println(matcher.group(1));

第5步：解析 Android Manifest 属性

在处理 XML 片段或日志时，常需抓取特定属性值。利用非贪婪匹配 (.+?) 提取键值对：

复制代码代码如下:

// 获得匹配值
String temp = "<meta-data android:name=\"appid\" android:value=\"joy\"/>";
pattern = Pattern.compile("android:(name|value)=\"(.+?)\"");
matcher = pattern.matcher(temp);
while(matcher.find()) {
    // out: appid, joy (取决于 group 索引)
    System.out.println(matcher.group(2));
}