java的`string.replacefirst()`默认将参数视为正则表达式，若待替换字符串含`|`、`*`、`+`等元字符会导致意外行为；使用`pattern.quote()`可自动转义所有正则元字符，实现字面量精准替换。
在HTML片段解析等场景中，我们常需按固定标签或文本片段逐步拆分字符串，并在提取后从原字符串中移除已处理部分。此时若直接调用 text.replaceFirst(s, "")，而 s 中包含正则元字符（如
正确做法：始终对字面量搜索串调用 Pattern.quote()
该方法会将任意字符串（无论是否含 .、^、$、|、?、*、+、(、)、[、]、{、}、\ 等）自动包裹为 \Q...\E 形式，确保其被当作纯文本处理：
import java.util.regex.Pattern; String input = "text | more "; String[] expected = {"", "text | more", " "}; // 模拟分步提取与移除 for (String part : expected) { // ✅ 安全替换：Pattern.quote(part) 生成 \Qtext | more\E，完全规避正则解析 input = input.replaceFirst(Pattern.quote(part), ""); System.out.println("移除 '" + part + "' 后: \"" + input + "\""); } // 输出依次为： // 移除 '' 后: "text | more " // 移除 'text | more' 后: "" // 移除 '' 后: ""
⚠️ 注意事项：
- Pattern.quote() 仅用于字面量精确匹配，不支持通配或正则逻辑；若需正则能力，请手动转义或重构逻辑。
- replaceFirst() 始终只替换第一个匹配项，符合分步解析需求；如需全部替换，请改用 replaceAll() 配合 Pattern.quote()。
- 对于高频操作（如大规模HTML解析），建议结合 StringBuilder 和索引定位提升性能，避免重复字符串创建。
总结：Pattern.quote(str) 是 replaceFirst / replaceAll / split 等正则方法的“字面量安全开关”，一行调用即可消除手动转义的错误风险，是处理用户输入、HTML 片段、配置值等不可信字符串时的必备实践。
