java的`string.replacefirst()`默认将参数视为正则表达式，若待替换字符串含`|`、`+`、`*`等元字符会导致误匹配；使用`pattern.quote()`可自动转义任意字符串，确保字面量精确替换，避免手动逃逸错误。
在HTML字符串解析等场景中，我们常需按顺序提取并移除已匹配的片段（如标签、内容文本），此时若直接调用 str.replaceFirst(substring, "")，而 substring 中包含正则元字符（例如 "text | more" 中的 |），Java 会将其解释为“text 或 more”的逻辑或匹配，导致仅删除部分字符（如只删掉 "text "），严重破坏后续解析逻辑。
根本解决方案是：将待替换的字符串视为纯文本字面量（literal string），而非正则模式。Java 提供了标准工具——java.util.regex.Pattern.quote(String s)，它会自动为字符串中所有正则元字符添加反斜杠转义，生成一个安全的、可直接用于正则API的字面量模式。
✅ 正确做法示例：
import java.util.Arrays;
import java.util.regex.Pattern;
public class SafeReplaceExample {
public static void main(String[] args) {
String input = "text | more ";
// 模拟分词逻辑（此处以 '>' 为分割点）
String[] parts = input.split(Pattern.quote(">")); // 安全分割，避免 '>' 被误读
System.out.println("原始输入: " + input);
System.out.println("分割结果: " + Arrays.toString(parts)); // ["⚠️ 注意事项：
立即学习“Java免费学习笔记（深入）”；
- Pattern.quote() 返回的是正则安全的字面量模式，适用于 replaceFirst()、replaceAll()、split() 等所有接受正则表达式的 String/Pattern 方法；
- 不要对 replace()（非正则版）使用 Pattern.quote()，因其本身即按字面量处理，额外转义反而导致匹配失败；
- 若需频繁执行此类操作，建议缓存 Pattern.quote(s) 结果以提升性能（尤其在循环内）；
- 对于复杂 HTML 解析，仍推荐使用专业库（如 Jsoup），本方案适用于轻量、可控的字符串预处理场景。
总结：Pattern.quote(str) 是 Java 中处理“未知内容字符串需参与正则操作”的黄金方法——零配置、零遗漏、零歧义，让 replaceFirst() 真正成为可靠的“首次字面替换”工具。
