Java replace() 與 replaceAll() 深度對比：參數差異、性能與避坑指南

核心區別一覽

replace() 詳解

// 字符替換
"hello".replace('l', 'x')        // "hexxo"

// 字符串替換 (CharSequence)
"hello world".replace("l", "x")  // "hexxo worxd"
"hello".replace("ll", "xx")      // "hexxo"

// 不支持正則
"a1b2c3".replace("\\d", "#")     // "a1b2c3" (字面量匹配 "\\d")

replaceAll() 詳解

// 正則替換所有數字
"a1b2c3".replaceAll("\\d", "#")  // "a#b#c#"

// 正則替換連續數字
"abc123def456".replaceAll("\\d+", "X")  // "abcXdefX"

// 分組引用替換
"2024-01-15".replaceAll("(\\d{4})-(\\d{2})-(\\d{2})", "$3/$2/$1")  // "15/01/2024"

// 僅替換首次匹配
"a1b2c3".replaceFirst("\\d", "#")  // "a#b2c3"

性能對比 (JMH 參考)

高頻避坑指南

1. 反斜槓雙重轉義地獄

// 目標：將 "\" 替換為 "\\"
// Java 字符串轉義：\\ 代表 \
// 正則轉義：\\ 代表 \
// 結合：需要 4 個反斜槓
String path = "C:\\Users\\Admin";
path.replaceAll("\\\\", "/");  // "C:/Users/Admin"

// 更複雜：將 "\\" 替換為 "\\\\"
msgOut = msgIn.replaceAll("\\\\\\\\", "\\\\\\\\\\\\\\\\");
// 層層解碼：Java字符串 -> 正則引擎 -> 實際匹配

口訣：Java 層轉義一次，正則層轉義一次，共兩次。

2. 正則元字符未轉義導致錯誤

// 目標替換 "."
"1.2.3".replaceAll(".", "#")     // "###" 錯誤！. 匹配任意字符
"1.2.3".replaceAll("\\.", "#")   // "1#2#3" 正確
"1.2.3".replace(".", "#")        // "1#2#3" replace() 無此問題

正則元字符：. * + ? ^ $ { } [ ] | ( ) \ 使用 replaceAll 時必須轉義。

3. 空字符串替換陷阱

"abc".replaceAll("", "-")  // "-a-b-c-" (每個字符間+首尾插入)
"abc".replace("", "-")     // "-a-b-c-" 同理

4. null 參數拋 NPE

str.replace("a", null)      // NPE
str.replaceAll("a", null)   // NPE
str.replace(null, "b")      // NPE

最佳實踐建議

1. 字面量替換優先用 replace()：性能高、無轉義煩惱、語義清晰
2. 高頻正則替換預編譯 Pattern：

   private static final Pattern DIGITS = Pattern.compile("\\d+");
   public static String maskDigits(String input) {
       return DIGITS.matcher(input).replaceAll("*"); // 復用 Pattern
   }

3. 複雜替換邏輯用 Matcher.appendReplacement：逐個匹配處理，支持動態計算替換值
4. 僅替換首次用 replaceFirst()：語義明確，避免手動控制

源碼級理解

// String.replace(CharSequence target, CharSequence replacement)
public String replace(CharSequence target, CharSequence replacement) {
    return Pattern.compile(target.toString(), Pattern.LITERAL)
                  .matcher(this)
                  .replaceAll(Matcher.quoteReplacement(replacement.toString()));
}

// 內部實際調用了 Pattern + Matcher，但 Pattern.LITERAL 模式禁用正則語義
// 所以 replace() 本質是「字面量模式的 replaceAll」

理解兩者本質區別：replace = 字面量全局替換，replaceAll = 正則全局替換。選對工具，代碼更簡潔、性能更高、Bug 更少。