如何在Java中实现JavaScript式的正则.replace匹配替换逻辑？

问题背景 #

之前在JavaScript中用这段代码实现全局替换：

p = p.replace(new RegExp('\b' + '\w+' + '\b', 'g'), k[c])

它会一次性匹配字符串中所有处于单词边界的单词（比如示例字符串1-2.5.6/8/3.4?1=f-g&e=d&h=i里的1、2、f、g等），然后通过字典映射替换对应内容。

现在用Java实现相同逻辑时，原代码出现了重复替换的问题：

Pattern pattern = Pattern.compile("\\b\\w+\\b");
Matcher matcher = pattern.matcher(p);
while (matcher.find()) {
    String matchedString = matcher.group();
    String replacementString = z.apply(String.valueOf(matchedString));
    p = p.replace(matchedString, replacementString);
}

比如输入delivery45-2.5.6/8/3.4?1=f-g&e=d&h=i，替换后变成STRING_tliv56287592ry45-2.5.6/8/3.4?1=f-g&e=d&h=i，替换后的内容会被再次匹配替换，直到无法继续。

问题原因 #

JavaScript的replace方法带g标志时，会一次性扫描整个原始字符串，找到所有匹配项后统一替换，不会把替换后的内容重新纳入扫描范围。

而你当前的Java代码存在两个问题：

1. 每次调用p.replace(matchedString, replacementString)会替换字符串中所有等于matchedString的子串，不是只替换当前匹配的那一个；
2. 循环中每次matcher.find()会基于修改后的字符串重新扫描，导致替换后的内容里的符合规则的字符被再次匹配替换。

解决方案 #

使用Java Matcher类的appendReplacement()和appendTail()方法，这是实现和JS全局替换一致行为的标准方式，只会扫描原始字符串的匹配项，不会处理替换后的内容。

修正后的代码：

Pattern pattern = Pattern.compile("\\b\\w+\\b");
Matcher matcher = pattern.matcher(p);
StringBuffer result = new StringBuffer();

while (matcher.find()) {
    String matched = matcher.group();
    String replacement = z.apply(matched);
    // 转义替换内容中的特殊字符（如$、\），避免破坏正则替换逻辑
    matcher.appendReplacement(result, Matcher.quoteReplacement(replacement));
}
// 将最后一个匹配项之后的剩余内容追加到结果中
matcher.appendTail(result);

p = result.toString();

代码说明 #

• appendReplacement()：每次找到匹配项时，把匹配项之前的未匹配内容、替换后的内容追加到StringBuffer，只处理当前匹配的那一个位置，不会全局替换相同字符串；
• Matcher.quoteReplacement()：必须调用这个方法转义替换字符串中的特殊字符，比如替换内容包含$1时，不会被当作正则分组引用处理；
• appendTail()：处理完所有匹配项后，把最后一个匹配项之后的剩余内容追加到结果中，保证整个字符串完整。

内容的提问来源于stack exchange，提问作者test test