当前位置：首页 > 文章列表 > 文章 > java教程 > 正则替换$1、$2、${3}占位符技巧

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

2026-03-21 11:00:53 0浏览收藏

本文介绍了一种基于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
    }
}

✅ 关键优势说明：