正则替换$1、$2、${3}占位符技巧

本文介绍了一种基于Java 8+ `Matcher.replaceAll(Function)` 的高效、健壮的正则替换方案，专为处理形如 `$1`、`$11`、`${12}` 等位置参数占位符而设计——它通过单次正则扫描精准捕获所有编号，自动校准索引并安全填充数组值，彻底规避传统循环替换中的顺序干扰、越界风险与语法割裂问题，同时内置清晰的错误提示和边界防护，让模板字符串（如命令行指令或配置脚本）的参数化过程既简洁可靠又易于维护，堪称Java中轻量级模板引擎的核心实践。

本文介绍一种基于 Java 8+ `Matcher.replaceAll(Function)` 的健壮方案，用单次正则匹配高效替换形如 `$1`、`$11`、`${12}` 的位置参数占位符，避免手动遍历与顺序依赖问题，并兼顾边界安全性与可读性。

在命令行工具、脚本引擎或配置模板解析等场景中，常需将类似 "copy $1 to $2" 或 "run --mode=${3}" 这样的模板字符串，按索引顺序填充为实际值（如 args = {"src.txt", "dst/", "fast"} → "copy src.txt to dst/ --mode=fast"）。传统循环倒序替换虽能规避干扰，但逻辑冗余、易出错（如未校验索引越界），且无法统一处理 $n 和 ${n} 两种语法。

更优解是使用正则一次匹配 + 函数式替换。核心思路是：用正则精准捕获所有合法占位符中的数字编号，再通过回调函数动态计算对应数组元素（注意：占位符索引从 1 开始，而 Java 数组从 0 开始，需 -1 校准）。

以下是推荐实现：

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

public class TemplateReplacer {
    private static final Pattern PLACEHOLDER_PATTERN = 
        Pattern.compile("\\$\\{?(\\d+)}?"); // 匹配 $1、${12}，捕获内部数字

    public static String replacePlaceholders(String template, String[] args) {
        if (template == null || args == null) {
            return template;
        }
        return PLACEHOLDER_PATTERN.matcher(template)
            .replaceAll(match -> {
                int index;
                try {
                    index = Integer.parseInt(match.group(1)) - 1; // 转为 0-based 索引
                    if (index < 0 || index >= args.length) {
                        throw new IllegalArgumentException(
                            "Placeholder $" + match.group(1) + " out of bounds: args length is " + args.length);
                    }
                    return args[index];
                } catch (NumberFormatException e) {
                    throw new IllegalArgumentException("Invalid placeholder: " + match.group(0), e);
                }
            });
    }

    // 使用示例
    public static void main(String[] args) {
        String command = "move $1 to $2 while using the ISO-${3}34 standard";
        String[] values = {"X", "Y", "SC"};
        String result = replacePlaceholders(command, values);
        System.out.println(result);
        // 输出：move X to Y while using the ISO-SC34 standard
    }
}

✅ 关键优势说明：

• 单次扫描，无顺序依赖：正则自动按文本顺序匹配所有占位符，无需倒序规避 $1 替换影响 $11；
• 统一语法支持：\\$\\{?(\\d+)}? 精确覆盖 $1、$12、${3}、${100} 等全部合法变体；
• 强健错误处理：显式校验索引范围与数字格式，避免 ArrayIndexOutOfBoundsException 或静默失败；
• 零副作用：不修改原始字符串或数组，符合函数式编程原则。

⚠️ 注意事项：

• 占位符编号严格从 1 开始计数（非 0），若需支持 $0，请调整解析逻辑；
• 正则未转义 $ 后的非数字字符（如 $abc），如需支持命名参数（如 $name），应扩展正则并改用 Map 替换策略；
• 若 args 可能含 null 值，建议在回调中额外判空并决定是否替换为空字符串或保留原占位符。

该方案兼具简洁性、可维护性与生产级鲁棒性，是 Java 中模板化字符串参数化处理的标准实践之一。

本篇关于《正则替换$1、$2、${3}占位符技巧》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于文章的相关知识，请关注golang学习网公众号！