Java中如何用String数组值替换字符串中的$N、${N}占位符？

现有一个String类型的command字符串，以及一个传递给该命令的String[]类型args参数数组。假设数组长度匹配需求，需要将字符串中所有$1、$11、${12}这类占位符替换为数组中对应下标的元素。

示例：
若command为"move $1 to $2 while using the ISO-${3}34 standard"，args为{"X", "Y", "SC"}，替换后应得到"move X to Y while using the ISO-SC34 standard"。

当前实现代码如下：

for (int i = args.length - 1; i >= 0; i--) {
    String bracketedArg = "${" + i + "}";
    if (commandString.contains(bracketedArg)) {
        commandString = commandString.replace(bracketedArg, args[i]);
        continue;
    }
    else {
        String arg = "$" + i;
        commandString = commandString.replace(arg, args[i]);
    }
}

请问是否有更健壮的实现方式？我尝试使用正则表达式但不知如何替换匹配项：

Pattern pattern = Pattern.compile("\\{?\\$(\\d+)}");
commandString = pattern.matcher(commandString).replaceAll(???);

现有代码的潜在问题 #

当前实现存在几个明显隐患：

• 多位数占位符会被误替换：比如先替换$1时，会把$11里的$1部分提前替换，导致后续$11无法匹配；
• 匹配精度不足：如果字符串中存在类似$100的内容，替换$1时会错误修改其中的$1片段；
• 多次调用replace和contains，效率较低且逻辑冗余。

正则表达式的正确实现 #

可以通过优化正则表达式，结合函数式替换逻辑，实现精准且高效的占位符替换：

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

public class PlaceholderReplacer {
    public static String replacePlaceholders(String command, String[] args) {
        // 正则精准匹配两种占位符格式：$数字 或 ${数字}
        Pattern pattern = Pattern.compile("\\$(?:(\\d+)|\\{(\\d+)})");
        Matcher matcher = pattern.matcher(command);
        
        return matcher.replaceAll(matchResult -> {
            // 提取匹配到的数字：组1对应$数字格式，组2对应${数字}格式
            String numStr = matchResult.group(1) != null ? matchResult.group(1) : matchResult.group(2);
            // 占位符是1-based，数组下标是0-based，所以要减1
            int index = Integer.parseInt(numStr) - 1;
            // 题目假设数组长度匹配，直接返回对应元素即可
            return args[index];
        });
    }
}

正则说明：

• \\$：匹配占位符的$前缀；
• (?:...)：非捕获组，用来区分两种占位符格式：
  • (\\d+)：捕获$后直接跟的数字（如$1中的1）；
  • \\{(\\d+)}：捕获${}包裹的数字（如${3}中的3）；
• 函数式替换逻辑：每次匹配到占位符时，提取数字转成数组下标，返回对应的args元素。

边界情况优化 #

如果需要处理占位符数字超出数组长度、非数字占位符等异常场景，可以在替换逻辑中添加校验：

return matcher.replaceAll(matchResult -> {
    String numStr = matchResult.group(1) != null ? matchResult.group(1) : matchResult.group(2);
    try {
        int index = Integer.parseInt(numStr) - 1;
        if (index >= 0 && index < args.length) {
            return args[index];
        }
        // 下标越界时保留原占位符
        return matchResult.group();
    } catch (NumberFormatException e) {
        // 无法解析为数字时保留原占位符
        return matchResult.group();
    }
});

内容的提问来源于stack exchange，提问作者Mate de Vita