string.contains() 是判断子串是否存在的直观方法，但需注意：参数不可为 null，区分大小写，空字符串恒返回 true，不支持正则；安全调用须先判空，忽略大小写推荐 regionmatches() 而非 tolowercase()。

Java 中 String.contains() 是最常用、最直观的子串判断方法，但它有明确的行为边界和常见陷阱，用对了省事，用错了会抛异常或逻辑出错。

contains() 的基本用法和核心规则

它是一个实例方法，调用形式为 str.contains(sub)，返回 true 表示连续出现、false 表示未找到。关键点包括：

• 参数类型是 CharSequence（支持 String、StringBuilder 等），但绝对不能传 null，否则立刻抛 NullPointerException
• 区分大小写："ABC".contains("abc") 返回 false
• 空字符串 "" 是合法参数，且恒返回 true（Java 规范定义空串是任意字符串的子串）
• 只做字面量匹配，不支持通配符、正则语法或模糊搜索

安全调用：必须先判空

实际开发中，子串变量常来自用户输入或外部接口，可能为 null。直接调用 str.contains(sub) 风险极高。正确写法是：

• sub != null && str.contains(sub)
• 如果 str 本身也可能为 null，需前置判断：str != null && sub != null && str.contains(sub)

忽略大小写的替代方案

contains() 没有忽略大小写的重载版本。不要用 str.toLowerCase().contains(sub.toLowerCase())，原因有两个：

Java Maven Common

Java Maven 项目审查工作流的通用输入处理。当 Java Maven 项目以 ZIP压缩包或 GitLab 仓库 URL 形式提供且需要...时使用。

下载

• 非 ASCII 字符（如德语 ß、土耳其语 I）在不同区域设置下转换结果不稳定
• 每次调用都创建新字符串，循环中性能损耗明显

推荐用 regionMatches() 手动实现：

public static boolean containsIgnoreCase(String str, String sub) {
    if (str == null || sub == null) return false;
    int len = sub.length();
    if (len == 0) return true;
    for (int i = 0; i <h3>性能与等价写法</h3><p><code>str.contains(sub)</code> 在 JDK 内部就是 <code>str.indexOf(sub) >= 0</code> 的封装，二者行为完全一致、性能无差别。如果已有代码在用 <code>indexOf()</code>，无需刻意改写；若追求语义清晰，优先选 <code>contains()</code>。</p><p>需要正则能力（如“以数字开头+下划线+字母”）时，<code>contains()</code> 不适用，应改用 <code>Pattern.compile("...").matcher(str).find()</code> 或 <code>StringUtils.containsAny()</code>（Apache Commons Lang）。</p>

Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南