Java中replace、replaceAll与replaceFirst的区别及陷阱

三种替换方法的行为差异

许多开发者误以为 replace 仅替换单个实例，而 replaceAll 替换所有实例，这种理解是不准确的。真正的区别在于是否启用正则表达式引擎：

• replace(CharSequence target, CharSequence replacement)：执行字面量替换，不涉及正则解析，会替换目标字符串的所有匹配项。
• replaceAll(String regex, String replacement)：第一个参数被视为正则表达式，替换所有匹配的子串。
• replaceFirst(String regex, String replacement)：第一个参数被视为正则表达式，仅替换第一个匹配的子串。

以下代码演示了使用点号 . 进行替换的效果：

String s = "my.test.txt";
System.out.println(s.replace(".", "#"));
System.out.println(s.replaceAll(".", "#"));
System.out.println(s.replaceFirst(".", "#"));

运行结果如下：

my#test#txt
###########
#y.test.txt

结果分析：

1. replace：因为不使用正则，. 被当作普通字符查找，所以将两个点号都替换成了 #。
2. replaceAll：点号 . 是正则表达式的元字符，代表“匹配除换行符以外的任意字符”。因此它匹配了字符串中的每一个字符，导致全部变成 #。
3. replaceFirst：同样使用正则，但只替换第一个匹配到的任意字符，即首字母 'm' 被替换。

正则元字符带来的常见问题

由于 replaceAll 和 replaceFirst 涉及正则解析，若操作不当极易引发错误或产生非预期结果。主要存在两类风险：

1. 目标字符需转义

如果不想让某些具有特殊含义的字符触发正则逻辑，需要对其进行转义。例如，想精确替换点号：

s.replaceFirst("\\.", "#") // 结果为: my#test.txt

常用的需要警惕的正则元字符包括：

• .：匹配除换行符以外的任意字符
• ^：匹配字符串的开始
• $：匹配字符串的结束
• *：重复零次或更多次
• +：重复一次或更多次
• ?：重复零次或一次

2. 替换内容含特殊符号导致的报错

不仅第一个参数是正则，第二个参数（替换后的字符串）也会受到特殊字符影响。在旧的JDK版本（如JDK 1.4）及特定场景下，若替换内容包含斜杠 / 或美元符号 $，容易抛出 StringIndexOutOfBoundsException 或 No group 6 等异常。

测试案例：

// 尝试将 / 替换为 //

"/".replaceFirst("/", "//") 会抛出 java.lang.StringIndexOutOfBoundsException。

"/".replaceFirst("/", "$6") 会抛出 java.IndexOutOfBoundsException: No group 6（因为 $6 被正则引擎解析为第6个捕获组，而源字符串并无该组）。

安全替换的实现建议

当需要处理的字符串来源不可控（包含大量未预知的符号），或者为了追求更直观且稳定的行为时，建议避免直接使用原生的 replaceAll/replaceFirst。可以通过以下手写工具类实现纯字面量的全量或首个替换，避开正则引擎的副作用：

public class StringTools {
    /**
     * 全量字面量替换
     */
    static public String replaceAll(String str, String oldStr, String newStr) {
        int i = str.indexOf(oldStr);
        while(i != -1) {
            str = str.substring(0, i) + newStr + str.substring(i + oldStr.length());
            i = str.indexOf(oldStr, i + newStr.length());
        }
        return str;
    }

    /**
     * 首个字面量替换
     */
    static public String replaceFirst(String str, String oldStr, String newStr) {
        int i = str.indexOf(oldStr);
        if (i == -1) return str;
        return str.substring(0, i) + newStr + str.substring(i + oldStr.length());
    }
}

使用此自定义方法：

System.out.println(StringTools.replaceAll("/","/","//")); // 结果为: //

这种方法逻辑简单，完全不依赖正则解析，适合对性能要求不高但对稳定性有严格要求的业务场景。

总结

在Java中使用字符串替换时，请牢记 replace 是安全的字面量替换，而 replaceAll 和 replaceFirst 具备强大的正则能力同时也伴随着复杂的风险。处理含有特殊元字符的目标串或替换串时，务必做好转义检查或采用索引定位的方式进行替代。以上就是Java字符串替换方法的详细内容，更多关于Java进阶技巧的资料请关注本站其它相关文章！