Java如何不逐字符检查，正确替换未知占位符并保留%？

需求说明 #

需要替换字符串中%包裹的占位符（如%test%替换为SERVER、%name%替换为用户名），但占位符无法提前预知：

• 有效占位符：替换为对应值
• 无效占位符（映射表中不存在的）：保留原%xxx%格式
• 单独的%（非占位符的一部分）：直接保留

示例 #

输入：

abc %some%%test% efz %other% fref%
Some line with 1% of %some_placeholders%

预期输出：

abc %some%SERVER efz %other% fref%
Some line with 1% of %some_placeholders%

高效实现方案 #

利用正则表达式结合Matcher的appendReplacement方法实现，无需逐字符遍历，性能更优：

1. 完整实现代码

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

public class PlaceholderReplacer {
    public static void main(String[] args) {
        // 存放有效占位符与对应替换值的映射
        Map<String, String> placeholderMap = new HashMap<>();
        placeholderMap.put("test", "SERVER");
        placeholderMap.put("name", "用户名");

        String input = "abc %some%%test% efz %other% fref%\nSome line with 1% of %some_placeholders%";
        // 正则规则：匹配%xxx%（捕获占位符名称）或单独的%
        Pattern pattern = Pattern.compile("%([^%]+)%|%");
        Matcher matcher = pattern.matcher(input);
        StringBuffer result = new StringBuffer();

        while (matcher.find()) {
            if (matcher.group(1) != null) {
                // 匹配到%xxx%格式的占位符
                String placeholderKey = matcher.group(1);
                // 存在映射则替换，否则保留原占位符
                String replacement = placeholderMap.getOrDefault(placeholderKey, matcher.group());
                // 转义替换内容中的特殊字符，避免正则替换异常
                matcher.appendReplacement(result, Matcher.quoteReplacement(replacement));
            } else {
                // 匹配到单独的%，直接保留
                matcher.appendReplacement(result, Matcher.quoteReplacement("%"));
            }
        }
        // 追加剩余未匹配的内容
        matcher.appendTail(result);

        System.out.println(result.toString());
    }
}

2. 关键逻辑说明

• 正则%([^%]+)%|%：分为两个匹配分支，精准覆盖两种情况：%包裹的占位符、单独的%
• Matcher.appendReplacement：逐段处理字符串，仅替换符合规则的部分，比全量替换更灵活高效
• Matcher.quoteReplacement：确保替换内容中的特殊字符（如$、\）不会破坏替换逻辑

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