这是一个非常基础且重要的方法，但初学者很容易将它与其他方法（如 lookingAt() 和 find()）混淆。
核心概念：matches() 方法是什么？
matches() 是 java.util.regex.Pattern 类的一个静态方法，也是 java.lang.String 类的一个实例方法,它的作用是：
判断整个输入字符串是否完全匹配给定的正则表达式模式。
关键点在于 “整个字符串”，这意味着，如果字符串中只有一部分符合模式，而其他部分不符合，matches() 方法也会返回 false。
方法签名
String 类中的 matches() 方法签名如下：
public boolean matches(String regex)
- 参数
regex：一个表示正则表达式模式的字符串。 - 返回值：如果整个字符串完全匹配该正则表达式，则返回
true；否则返回false。
使用方式
主要有两种方式调用 matches()：
通过 String 对象调用（最常用）
这是最直观、最常见的方式。
String str = "hello world";
boolean result = str.matches("hello world"); // 返回 true
boolean result2 = str.matches("hello"); // 返回 false，因为 str 不是 "hello"
通过 Pattern 和 Matcher 调用
这种方式更灵活，尤其是在需要多次使用同一个正则表达式进行匹配时,性能更好。
import java.util.regex.Pattern;
import java.util.regex.Matcher;
String str = "12345";
Pattern pattern = Pattern.compile("\\d+"); // 预编译正则表达式
Matcher matcher = pattern.matcher(str);
boolean result = matcher.matches(); // 返回 true，因为整个 "12345" 都由数字组成
代码示例与详细解释
让我们通过几个例子来深入理解 matches() 的行为。
示例 1：完全匹配
String email = "test@example.com";
// 正则解释：^ 表示开头，$ 表示结尾，中间是邮箱的常见格式。
String emailRegex = "^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\\.[a-zA-Z]{2,6}$";
boolean isEmail = email.matches(emailRegex);
System.out.println("Is '" + email + "' a valid email? " + isEmail); // 输出: Is 'test@example.com' a valid email? true
解释：这里的 ^ 和 确保了从字符串的第一个字符到最后一个字符都必须完全符合邮箱的格式，整个字符串 test@example.com 完全匹配，所以返回 true。
示例 2：部分匹配（matches() 的陷阱）
这是 matches() 最容易让人误解的地方。
String text = "abc123xyz";
String regex = "abc";
boolean result = text.matches(regex);
System.out.println("Does '" + text + "' match '" + regex + "'? " + result); // 输出: Does 'abc123xyz' match 'abc'? false
解释：虽然 text 的开头是 "abc"，但整个字符串还包括 "123xyz"。matches() 要求整个字符串都必须是 "abc"，所以它返回 false。
示例 3：匹配任意数量的字符
如果你想让一个模式匹配一个字符串，无论字符串后面还有什么，你应该使用 (或 )。
- 匹配除换行符外的任意字符。
- 表示前面的元素可以出现零次或多次。
- 组合起来就是“任意数量的任意字符”。
String text = "abc123xyz";
String regex = "abc.*"; // 匹配以 "abc" 开头，后面跟着任意字符的字符串
boolean result = text.matches(regex);
System.out.println("Does '" + text + "' match '" + regex + "'? " + result); // 输出: Does 'abc123xyz' match 'abc.*'? true
解释：abc.* 模式要求字符串以 "abc" 开头， 会贪婪地匹配剩余的所有字符 "123xyz"，整个字符串 abc123xyz 完全符合这个模式，所以返回 true。
matches() vs. lookingAt() vs. find()
理解这三个方法的区别是掌握 Java 正则的关键。
| 方法 | 描述 | 匹配范围 | 返回 true 的例子 |
|---|---|---|---|
matches() |
整个字符串必须完全匹配正则表达式。 | 整个输入字符串 | "abc123".matches("abc123") -> true"abc123".matches("abc") -> false |
lookingAt() |
从字符串的开头开始匹配，不需要匹配整个字符串。 | 字符串的开头部分 | "abc123".lookingAt("abc") -> true"123abc".lookingAt("abc") -> false |
find() |
在字符串中查找任意位置是否存在匹配的子串。 | 字符串中的任意子串 | "abc123".find("123") -> true"hello 123 world".find("\\d+") -> true |
代码对比
import java.util.regex.Pattern;
import java.util.regex.Matcher;
String text = "hello 123 world";
Pattern p = Pattern.compile("\\d+"); // 匹配一个或多个数字
Matcher m = p.matcher(text);
// 1. matches()
// 检查整个 "hello 123 world" 是否都是数字？显然不是。
System.out.println("matches(): " + m.matches()); // 输出: matches(): false
// 2. lookingAt()
// 检查开头 "hello" 是否是数字？不是。
System.out.println("lookingAt(): " + m.lookingAt()); // 输出: lookingAt(): false
// 3. find()
// 检查字符串中是否存在 "123" 这个子串？存在。
System.out.println("find(): " + m.find()); // 输出: find(): true
// find() 可以继续查找下一个匹配项
System.out.println("find() next: " + m.find()); // 输出: find() next: false (没有更多匹配项)
总结与最佳实践
-
当你需要验证整个字符串格式时，使用
matches()，验证一个完整的邮箱地址、手机号、身份证号等。if (input.matches("^1[3-9]\\d{9}$")) { // 这是一个有效的中国大陆手机号 } -
当你只需要检查字符串开头是否符合某个模式时，使用
lookingAt()，检查一个字符串是否以 "http://" 或 "https://" 开头。 -
当你想在字符串中搜索一个或多个匹配的子串时，使用
find(),从一段文本中提取所有电话号码或所有邮箱地址。 -
matches()的“全有或全无”特性：它要么匹配整个字符串，要么完全不匹配，如果只想匹配字符串的一部分，请使用find()或确保你的正则表达式包含了整个字符串（例如使用 ）。 -
性能考虑：如果要对同一个正则表达式进行多次匹配（例如在循环中），最好使用
Pattern.compile()预编译正则表达式，然后复用Matcher对象，这比每次都调用String.matches()更高效。
