本文介绍一种基于 Java 正则表达式的健壮方案，用于将形如 $1、$11、${12} 的占位符精准替换为字符串数组中对应索引（1-based）的值，避免手动遍历和顺序错误风险。
本文介绍一种基于 java 正则表达式的健壮方案，用于将形如 `$1`、`$2`、`${3}` 的占位符精准替换为字符串数组中对应索引（1-based）的值，避免手动遍历和顺序错误风险。
在命令行解析、模板填充或动态脚本生成等场景中，常需将类似 $1、$11 或 ${12} 这样的占位符按顺序替换为参数数组中的实际值。若采用从后往前遍历 + 多次 String.replace() 的方式（如原始代码所示），不仅逻辑冗余、易出错（例如 $1 会被 $11 中的子串误匹配），还无法统一处理带花括号与不带花括号的两种语法。
更优解是使用 正则匹配 + 函数式替换：通过 Pattern 精确定义占位符模式，并借助 Matcher.replaceAll(Function<MatchResult, String>) 实现一次扫描、安全替换。
✅ 推荐实现（Java 9+）
import java.util.regex.Pattern;
import java.util.regex.MatchResult;
public class PlaceholderReplacer {
private static final Pattern PLACEHOLDER_PATTERN = Pattern.compile("\$\{?(\d+)}?");
public static String replacePlaceholders(String template, String[] args) {
if (template == null || args == null) {
return template;
}
return PLACEHOLDER_PATTERN.matcher(template)
.replaceAll(match -> {
int index = Integer.parseInt(match.group(1)) - 1; // 转为 0-based 索引
if (index < 0 || index >= args.length) {
throw new IllegalArgumentException(
String.format("Placeholder %s references out-of-bounds argument index %d",
match.group(0), index + 1));
}
return args[index];
});
}
// 使用示例
public static void main(String[] args) {
String command = "move $1 to $2 while using the ISO-${3}34 standard";
String[] params = {"X", "Y", "SC"};
String result = replacePlaceholders(command, params);
System.out.println(result); // 输出：move X to Y while using the ISO-SC34 standard
}
}? 正则说明
- \$：匹配字面量 $（需转义）
- \{?：可选的 {（? 表示零次或一次）
- (\d+)：捕获一个或多个数字（即参数序号），这是后续 match.group(1) 获取的内容
- }?：可选的 }
该模式能同时匹配：
- $1 → group(1) = "1"
- $11 → group(1) = "11"
- ${12} → group(1) = "12"
✅ 完全规避了 $1 与 $11 的子串冲突问题（正则贪婪匹配确保最长数字被识别）。
⚠️ 注意事项
- 索引越界检查必须显式处理：正则本身不校验数组长度，应在 replaceAll 的 lambda 中验证 index 是否在 [0, args.length) 范围内，否则抛出明确异常，而非静默失败或 ArrayIndexOutOfBoundsException。
- 空参数/空模板防护：如示例所示，应提前对 null 输入做防御性判断。
- 性能考量：对于高频调用场景，将 Pattern 提取为 static final 常量（如上例），避免重复编译开销。
- 扩展性提示：若需支持默认值（如 ${1:-default}）或嵌套表达式，建议切换至成熟模板引擎（如 Apache Commons Text StringSubstitutor 或 Mustache），而非自行增强正则逻辑。
此方案简洁、高效、可读性强，是替代手工循环替换的标准实践。
