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的字面量模式。

✅ 正确做法示例：

html-to-pptx-converter

使用 PptxGenJS 和 Python 解析，将结构化的 HTML/CSS 幻灯片内容转换为原生、可编辑的 PowerPoint（.pptx）演示文稿。

下载

import java.util.Arrays;
import java.util.regex.Pattern;

public class SafeReplaceExample {
    public static void main(String[] args) {
        String input = "<title>text | more</title>";
        // 模拟分词逻辑（此处以 '>' 为分割点）
        String[] parts = input.split(Pattern.quote(">")); // 安全分割，避免 '>' 被误读

        System.out.println("原始输入: " + input);
        System.out.println("分割结果: " + Arrays.toString(parts)); // ["<title", "text | more</title"]

        // 逐个提取并安全移除（关键：用 Pattern.quote 包裹待替换字符串）
        for (String part : parts) {
            if (!part.isEmpty()) {
                // ✅ 安全替换首个字面量匹配
                input = input.replaceFirst(Pattern.quote(part), "");
                System.out.println("移除 '" + part + "' 后: " + input);
            }
        }
    }
}

⚠️ 注意事项：

立即学习“Java免费学习笔记（深入）”；

• Pattern.quote() 返回的是正则安全的字面量模式，适用于 replaceFirst()、replaceAll()、split() 等所有接受正则表达式的 String/Pattern 方法；
• 不要对 replace()（非正则版）使用 Pattern.quote()，因其本身即按字面量处理，额外转义反而导致匹配失败；
• 若需频繁执行此类操作，建议缓存 Pattern.quote(s) 结果以提升性能（尤其在循环内）；
• 对于复杂 HTML 解析，仍推荐使用专业库（如 Jsoup），本方案适用于轻量、可控的字符串预处理场景。

总结：Pattern.quote(str) 是 Java 中处理“未知内容字符串需参与正则操作”的黄金方法——零配置、零遗漏、零歧义，让 replaceFirst() 真正成为可靠的“首次字面替换”工具。