在java中使用`string.replacefirst()`时，若待替换的字符串包含`|`、`(`、`*`等正则元字符，会触发正则匹配而非字面量匹配，导致意外行为。可通过`pattern.quote()`自动转义所有元字符，实现安全、准确的首次字面量替换。
处理HTML片段等含特殊符号的文本时，常需按字面量精确提取并移除子串（如"
根本原因在于：replaceFirst(String regex, String replacement) 的第一个参数是正则表达式，而非纯字符串。解决方案是使用 Pattern.quote(String s) 对待替换字符串进行自动转义，该方法会将任意字符串包装为字面量模式（例如Pattern.quote("text | more")返回"text \| more"），确保完全按字符逐字匹配：
import java.util.regex.Pattern; String input = "<title>text | more</title>"; String toRemove = "text | more"; // ✅ 安全替换：自动转义所有正则元字符 input = input.replaceFirst(Pattern.quote(toRemove), ""); System.out.println(input); // 输出："<title></title>"
在分片解析流程中，应统一应用此模式。以下是一个健壮的HTML标签提取示例：
java-api-doc-generator
下载
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
import java.util.*;
import java.util.regex.Pattern;
public class HtmlSplitter {
public static List<String> extractParts(String html) {
List<String> parts = new ArrayList<>();
String temp = html;
// 按 '>' 分割（注意：此处 split 也需 quote，因 '>' 是普通字符，但为演示一致性仍使用）
String[] segments = temp.split(Pattern.quote(">"));
for (String seg : segments) {
if (seg.trim().isEmpty()) continue;
// 提取完整标签部分（含 '>'）
String partWithEnd = seg + ">";
parts.add(partWithEnd);
// 安全移除已提取部分（字面量替换）
temp = temp.replaceFirst(Pattern.quote(partWithEnd), "");
}
return parts;
}
public static void main(String[] args) {
String input = "<title>text | more</title>";
List<String> result = extractParts(input);
System.out.println(result);
// 输出：[<title>, text | more>, </title>]
}
}⚠️ 注意事项：
立即学习“Java免费学习笔记（深入）”；
- Pattern.quote() 是标准库提供的零配置方案，绝不建议手动拼接反斜杠（易遗漏、跨平台转义差异大）；
- 若需多次替换相同字面量，可预先计算 quoted = Pattern.quote(s) 复用，提升性能；
- replaceFirst() 仅替换首个匹配项，符合“提取一次即移除”的语义；如需全部替换，请改用 replaceAll(Pattern.quote(s), "")；
- 对于复杂HTML解析，仍推荐使用专业库（如Jsoup），本方案适用于轻量、可控的结构化文本预处理。
综上，Pattern.quote() 是解决字面量字符串安全替换问题的标准、简洁且可靠的方案——它让开发者专注业务逻辑，而非与正则转义搏斗。
