Java 中主要有三个与 replace 相关的方法，它们分别处理不同类型的替换需求：

1. replace(char oldChar, char newChar)：替换字符
2. replace(CharSequence target, CharSequence replacement)：替换字符序列（字符串）
3. replaceAll(String regex, String replacement)：使用正则表达式进行替换
4. replaceFirst(String regex, String replacement)：使用正则表达式替换第一个匹配项

下面我们逐一详细解释。

replace(char oldChar, char newChar)

这是最简单、最直接的 replace 方法，它会扫描整个字符串，并将所有的 oldChar 替换为 newChar。

特点：

• 参数：两个 char 类型。
• 功能：替换所有单个字符。
• 返回值：一个新的字符串，原始字符串不会被修改（因为 Java 的字符串是不可变的）。
• 大小写敏感：严格区分大小写。

示例代码：

public class ReplaceCharExample {
    public static void main(String[] args) {
        String str = "hello world, hello java";
        // 将所有的 'l' 替换为 'p'
        String newStr = str.replace('l', 'p');
        System.out.println("原始字符串: " + str);
        System.out.println("替换后字符串: " + newStr);
        // 输出:
        // 原始字符串: hello world, hello java
        // 替换后字符串: hepwo worpd, hep java
    }
}

replace(CharSequence target, CharSequence replacement)

这是最常用的 replace 方法之一，它用于替换字符串中的子串（target）。

特点：

• 参数：两个 CharSequence 接口类型（通常直接用 String 即可）。
• 功能：替换所有匹配的子串。
• 返回值：一个新的字符串。
• 大小写敏感：严格区分大小写。
• 非正则表达式：target 参数被当作普通字符串来处理，而不是正则表达式。

示例代码：

public class ReplaceStringExample {
    public static void main(String[] args) {
        String str = "I like Java, Java is fun.";
        // 将所有的 "Java" 替换为 "Python"
        String newStr = str.replace("Java", "Python");
        System.out.println("原始字符串: " + str);
        System.out.println("替换后字符串: " + newStr);
        // 输出:
        // 原始字符串: I like Java, Java is fun.
        // 替换后字符串: I like Python, Python is fun.
        System.out.println("--------------------");
        // 尝试替换大小写不匹配的字符串
        String noChange = str.replace("java", "Python");
        System.out.println("尝试替换 'java' (大小写不匹配): " + noChange);
        // 输出:
        // 尝试替换 'java' (大小写不匹配): I like Java, Java is fun. (无变化)
    }
}

replaceAll(String regex, String replacement) 和 replaceFirst(String regex, String replacement)

这两个方法都使用正则表达式来匹配字符串，这是它们与前两个方法最大的区别。

replaceAll(String regex, String replacement)

• 功能：使用给定的正则表达式 regex 匹配字符串，并将所有匹配到的部分替换为 replacement。

replaceFirst(String regex, String replacement)

• 功能：使用给定的正则表达式 regex 匹配字符串，并将第一个匹配到的部分替换为 replacement。

特点：

• 参数：第一个参数是 String regex（正则表达式），第二个是 String replacement（替换字符串）。
• 返回值：一个新的字符串。
• 符号特殊含义：在 replacement 字符串中，可以使用 $1, $2 等来引用正则表达式中的捕获组。

示例代码：

public class ReplaceRegexExample {
    public static void main(String[] args) {
        String str = "order-12345, order-67890, order-54321";
        // 1. replaceAll: 替换所有匹配项
        // 将所有 "order-" 开头的字符串替换为 "product-"
        String allReplaced = str.replaceAll("order-", "product-");
        System.out.println("replaceAll 结果: " + allReplaced);
        // 输出:
        // replaceAll 结果: product-12345, product-67890, product-54321
        System.out.println("--------------------");
        // 2. replaceFirst: 只替换第一个匹配项
        String firstReplaced = str.replaceFirst("order-", "product-");
        System.out.println("replaceFirst 结果: " + firstReplaced);
        // 输出:
        // replaceFirst 结果: product-12345, order-67890, order-54321
        System.out.println("--------------------");
        // 3. 使用捕获组
        // 将 "order-12345" 格式的字符串，替换为 "订单号: 12345"
        // (\\d+) 是一个正则表达式，表示匹配一个或多个数字，并创建一个捕获组
        String withGroup = str.replaceAll("order-(\\d+)", "订单号: $1");
        System.out.println("使用捕获组结果: " + withGroup);
        // 输出:
        // 使用捕获组结果: 订单号: 12345, 订单号: 67890, 订单号: 54321
    }
}

总结与对比

如何选择？

1. 只想替换单个字符？

   • 使用 replace(char oldChar, char newChar)。

2. 想替换一个固定的子串（"apple" -> "orange"）？

   • 使用 replace(CharSequence target, CharSequence replacement)，这是最安全、最不容易出错的选择，因为你不需要担心正则表达式中的特殊字符（如 等）。

3. 需要根据某种模式进行替换（比如替换所有数字、所有空格、所有邮箱地址等）？

   • 使用 replaceAll() 或 replaceFirst()，这时你需要了解基本的正则表达式。

一个常见的错误：

// 错误的用法：想删除所有点号，但 . 在正则中表示任意字符
String path = "www.example.com/path";
String wrongResult = path.replace(".", "_"); // 错误！
// 结果会是 "www_example_com_path"，因为 . 匹配了所有字符
// 正确的用法
String correctResult = path.replace(".", "_"); // 如果你真的想替换所有字符，那这是对的
// 但如果你想只替换点号，应该用反斜杠转义
String dotReplaced = path.replaceAll("\\.", "_"); // 正确！
// 结果是 "www_example_com/path"

最佳实践： 如果你只想替换一个固定的字符串，总是优先选择 replace(CharSequence, CharSequence)，这样可以避免正则表达式带来的意外行为，只有当你确实需要模式匹配时，才使用 replaceAll 或 replaceFirst。