本文介绍如何用 Java 正则表达式配合 Matcher.replaceAll(Function) 实现安全、健壮的模板字符串参数替换，支持 $1、$11、${3} 等多种格式，并自动映射到字符串数组对应索引（1-based）。
本文介绍如何用 java 正则表达式配合 `matcher.replaceall(function)` 实现安全、健壮的模板字符串参数替换，支持 `$1`、$11、`${3}` 等多种格式，并自动映射到字符串数组对应索引（1-based）。
在命令行工具、配置模板解析或动态 SQL 构建等场景中，常需将形如 $1、${2}、$15 的占位符按顺序替换为实际参数值。关键挑战在于：
- 占位符格式不统一（带花括号/无花括号、数字位数可变）；
- 替换需严格按 1-based 索引匹配（即 $1 → args[0]，${12} → args[11]）；
- 避免误替换（如 $1 不应匹配 $11 中的前缀）；
- 代码需简洁、可读、线程安全。
✅ 推荐方案：正则 + 函数式替换（Java 9+）
使用 Pattern.compile("${?(d+)}?") 匹配所有合法占位符，并通过 Matcher.replaceAll(Function) 动态计算替换值：
import java.util.regex.Pattern;
public class TemplateReplacer {
public static String replaceArgs(String template, String[] args) {
if (template == null || args == null) {
return template;
}
Pattern pattern = Pattern.compile("\$\{?(\d+)}?");
return pattern.matcher(template)
.replaceAll(mr -> {
int index = Integer.parseInt(mr.group(1)) - 1; // 转为 0-based
if (index < 0 || index >= args.length) {
throw new IllegalArgumentException(
String.format("Placeholder %s references out-of-bounds index: %d",
mr.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[] values = {"X", "Y", "SC"};
String result = replaceArgs(command, values);
System.out.println(result);
// 输出：move X to Y while using the ISO-SC34 standard
}
}? 正则详解
- \$：字面量 $（需转义）；
- \{?：可选的 {；
- (\d+)：捕获一个或多个数字（核心分组，用于提取序号）；
- }?：可选的 }；
该模式能精准匹配 $1、${12}、$100，且不会跨边界匹配（例如 $11 不会被拆成 $1 + 1），优于逐个 String.replace() 的暴力遍历。
⚠️ 注意事项
- 索引越界检查必须显式处理：正则不校验数组长度，务必在回调中验证 index 范围，否则抛 ArrayIndexOutOfBoundsException；
- 空参数安全：建议对 null 输入做防御性判断（如示例所示）；
- 性能考量：对于高频调用，可将 Pattern 编译为 static final 常量复用；
- 扩展性提示：若需支持命名占位符（如 $name）或默认值（如 ${timeout:-3000}），应升级为专用模板引擎（如 Apache Commons Text 的 StringSubstitutor）。
✅ 对比原始实现的优势
| 维度 | 原始 for 循环方案 | 正则函数式方案 |
|---|---|---|
| 正确性 | ❌ 易受顺序影响（如先替 $1 再替 $11 导致错误） | ✅ 一次扫描，精确匹配完整占位符 |
| 可读性 | ❌ 多层条件、重复逻辑 | ✅ 声明式，意图清晰 |
| 扩展性 | ❌ 新增格式需修改循环逻辑 | ✅ 仅调整正则即可支持新语法（如 $[n]） |
| 安全性 | ❌ 无越界检查，静默失败风险 | ✅ 可集中抛出语义化异常 |
掌握这一模式，你不仅能优雅解决模板替换问题，更能举一反三应用于日志格式化、HTTP 路径参数注入、DSL 解析等各类文本动态插值场景。
