String.regionMatches() 是 Java 中轻量高效且不区分大小写的子串比对方法，适用于在 XML/JSON 等长报文中快速定位验证固定标识头如 "START:"、"HDR|"。
string.regionmatches()
是
java
中一个轻量、高效且不区分大小写的子串比对方法，特别适合在长报文（如 xml/json/自定义协议报文）中快速定位和验证固定标识头（如
、
、
、
等），避免创建新字符串对象或正则引擎开销。
为什么 regionMatches() 更适合长报文头检测
在处理 KB 级甚至 MB 级的报文字符串时，常用方式如
或
存在隐式开销：前者内部仍调用 regionMatches，后者会新建子串（触发字符数组复制）。而
regionMatches 直接在原字符串底层 char 数组上做索引比对，零拷贝、无对象分配
，尤其在高频解析场景（如网关、协议解包）中优势明显。
基础用法：精准匹配起始标识头
检测报文开头是否为特定头（例如
）：
使用
参数说明：
ignoreCase=false 表示大小写敏感；toffset=0 表示从报文开头比；other 是待比对头字符串；ooffset=0 表示从头字符串首字符开始；len 是头长度
示例代码：
进阶技巧：跳过空白/支持偏移定位
实际报文中头可能不在绝对开头（如含 BOM、换行、空格、注释行），可结合
+
快速定位：
Eclipse导入Android或其他的JAVA项目的正确方法 WORD版
本文档主要讲述的是Eclipse导入Android或其他的JAVA项目的正确方法；希望本文档会给有需要的朋友带来帮助；感兴趣的朋友可以过来看看
下载
立即学习
“
Java免费学习笔记（深入）
”；
先用
找到疑似起始位置（如第一个非空白字符、或某关键字后）
再用
在该位置校验头内容，避免全量扫描
支持忽略大小写（如匹配
或
）只需将第一个参数设为
示例（跳过前导空白后匹配）：
注意事项与避坑点
越界安全
：regionMatches 不会抛
，若
或
，直接返回
—— 这是优点，但需确保逻辑上允许“长度不足即不匹配”
不支持通配或模糊匹配
：它只做精确字符比对。如需匹配
，应先用 regionMatches 验证固定前缀，再自行解析后续字段
中文/Unicode 安全
：regionMatches 基于 UTF-16 编码单元比对，对常见中文、符号均正确；但若涉及代理对（如某些 emoji），需确认是否需按 code point 比较（此时 regionMatches 仍可用，但需确保 offset 指向正确位置）
"start:""hdr|"""begin pgp"str.startsWith("HDR|")str.substring(0, 4).equals("HDR|")"REQ|V2|"regionMatches(boolean ignoreCase, int toffset, String other, int ooffset, int len)String message = "REQ|V2|SN=12345|DATA=...";
String header = "REQ|V2|";
if (message.regionMatches(false, 0, header, 0, header.length())) {
System.out.println("识别到 V2 请求头");
}indexOfregionMatchesindexOfregionMatches"XML""xml"trueString msg = "\n\r \t...";
int start = 0;
while (start < msg.length() && Character.isWhitespace(msg.charAt(start))) {
start++;
}
if (start < msg.length() &&
msg.regionMatches(true, start, "IndexOutOfBoundsExceptiontoffset + len > str.length()ooffset + len > other.length()false"HDR|2024|*"