特殊字符干扰Java方法：replaceFirst遇美元符替换失效

核心原因：replaceFirst()的替换参数有特殊语法 #

Java的String.replaceFirst()本质是基于正则匹配实现的，它的第二个入参不是普通文本，是正则替换的模板字符串，有固定的特殊规则：

• $符号后接数字时，会被解析为「捕获组引用」：比如$1代表正则匹配结果里第一个分组的内容，$0代表整个匹配到的字符串
• 反斜杠\是转义字符，用来表示普通的$或\本身

当你传入的替换文本本身带$（比如<some string$>）时，替换引擎会自动把$后面的字符当成捕获组编号解析：

• 如果$后面跟着非数字字符（比如你例子里$后面是>），会直接抛出IllegalArgumentException
• 如果$后面跟着的数字是不存在的捕获组编号，同样会触发异常，最终表现为替换操作失效。

当替换文本不包含$、\这类特殊字符时，不会触发上述特殊解析逻辑，因此你之前测试的带字母数字的普通替换可以正常运行，和你描述的表现完全匹配。

代码里的其他附加逻辑bug #

• 你把replaceFirst()的返回值赋值给了storyLine变量，但最终方法返回的还是原始的original字符串，哪怕替换逻辑正常执行，返回的结果也是未替换的原值，这也会干扰你对问题的判断。
• 你直接把截取到的占位符字符串作为replaceFirst()的第一个参数，如果占位符本身包含正则特殊字符（比如.、*、?），也会导致匹配逻辑出错，不过这不是你当前遇到的$问题的核心原因。

要让替换值里的$、\这类特殊字符被当成普通文本处理，推荐两种更适合你场景的实现：

• 方法1：用JDK内置的转义工具处理替换文本，把特殊字符自动转义，直接修改你原有逻辑即可（需要导入java.util.regex.Matcher）：

  public static String substituteWord(String original, String word) {
      int index1 = original.indexOf("<");
      int index2 = original.indexOf(">");
      // 对替换文本做正则转义，让$、\等字符被当成普通文本处理
      String safeWord = Matcher.quoteReplacement(word);
      return original.replaceFirst(original.substring(index1, index2+1), safeWord);
  }
  

• 方法2：完全绕开正则逻辑，用字符串切割拼接实现替换，对你这种已知固定位置的占位符替换场景来说，性能更好也不会触发任何正则特殊字符问题：

  public static String substituteWord(String original, String word) {
      int index1 = original.indexOf("<");
      int index2 = original.indexOf(">");
      // 直接拼接字符串，不需要处理任何正则语法
      return original.substring(0, index1) + word + original.substring(index2 + 1);
  }
  

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