如何正确替换Java字符串中括号内的指定数字对应内容？

问题背景 #

原字符串：

String test3 = "'[47]GSA - Format'!$X$13-[49]Summary!$H$7/1000-[51]Summary!$H$6/1000+150";

需要完成的替换：

• [47] → Fourty Seven.xlsx
• [49] → Fourty Nine.xlsx
• [51] → Fifty One.xlsx

期望输出：

Fourty Seven.xlsxGSA - Format'!$X$13-Fourty Nine.xlsxSummary!$H$7/1000-Fifty One.xlsxSummary!$H$6/1000+150

尝试了以下循环替换代码，但结果不符合预期：

for (String key : keys) {
        String value = dataMap.get(key);
        value = formatValue(value);
        // test3 = test3.replaceAll(" *\\[\\d+\\] *", value);
        // test3 = test3.replaceAll("\\[(.*?)\\]", "$1");
        test3 = test3.replaceAll("\\[" + key + "\\]", value);
        // test3 = test3.replaceAll(key, value);
    }

问题分析 #

你当前代码的核心问题在于误用了replaceAll方法：

1. replaceAll的第一个参数是正则表达式，若你的keys是数字字符串（如"47"），拼接后的正则\[47\]本身是正确的，但如果需要处理原字符串中[47]前的单引号，这个正则只会替换[47]，导致结果多出前置的'，与目标不符；
2. 若keys是带括号的字符串（如"[47]"），拼接后的正则会变成\\[[47]\\]，这会错误匹配[4]或[7]这类内容，而非精确的[47]。

此外，replaceAll会全局替换所有匹配正则的内容，若你的需求是精确替换指定的括号内容，用普通字符串替换的replace方法更安全直观。

解决方案 #

根据你的keys类型，选择对应的实现方式：

情况1：keys是不带括号的数字（如"47"、"49"） #

如果需要处理原字符串中[47]前的单引号（对应目标字符串的格式），可以分两步替换前缀+括号内容：

Map<String, String> dataMap = new HashMap<>();
dataMap.put("47", "Fourty Seven.xlsx");
dataMap.put("49", "Fourty Nine.xlsx");
dataMap.put("51", "Fifty One.xlsx");

String test3 = "'[47]GSA - Format'!$X$13-[49]Summary!$H$7/1000-[51]Summary!$H$6/1000+150";

for (Map.Entry<String, String> entry : dataMap.entrySet()) {
    String key = entry.getKey();
    String value = entry.getValue();
    // 替换带单引号的前缀+括号内容
    test3 = test3.replace("'[" + key + "]", value);
    // 替换带减号的前缀+括号内容
    test3 = test3.replace("-" + "[" + key + "]", "-" + value);
}

// 输出结果即为目标字符串
System.out.println(test3);

如果只需替换括号内容本身（不处理前缀），直接用普通字符串替换即可：

for (String key : keys) {
    String value = dataMap.get(key);
    value = formatValue(value);
    // 使用replace做普通字符串替换，避免正则元字符问题
    test3 = test3.replace("[" + key + "]", value);
}

情况2：keys是带括号的字符串（如"[47]"） #

直接使用replace方法进行普通字符串替换，无需处理正则转义：

for (String key : keys) {
    String value = dataMap.get(key);
    value = formatValue(value);
    test3 = test3.replace(key, value);
}

关键提示 #

• replace方法会替换所有匹配的普通字符串，不会解析正则元字符，适合这种精确匹配的场景；
• replaceAll适合复杂正则匹配的替换场景，但需要注意转义特殊字符，否则容易出现匹配错误。

内容的提问来源于stack exchange，提问作者Santosh_17