在 Java 中判断字符串中是否包含某个子串，最常用的方法是使用 **String 类的 contains()、indexOf() 或 matches() 方法**。其中，**contains() 适用于简单包含判断，indexOf() 适用于需要获取位置的场景，matches() 适用于基于正则表达式的复杂匹配需求**。在不同业务场景下，选择合适的方法不仅可以提升代码可读性，也有助于优化性能和可维护性。

## 一、为什么需要判断字符串是否包含子串

在实际开发中，Java 判断字符串是否有子串是非常高频的操作。无论是用户输入校验、日志分析、接口参数过滤，还是数据清洗处理，都离不开字符串包含判断这一基础能力。字符串匹配的效率和准确性，直接影响系统的稳定性与运行效率。

例如，在 Web 应用中，我们可能需要判断请求路径中是否包含某个关键字；在文本处理场景中，需要判断文本是否包含敏感词；在数据库查询优化前，也可能先进行字符串预过滤。这些场景都要求开发者熟练掌握 Java 字符串包含判断方法。

根据 Oracle 官方 Java 文档（Oracle, 2023），String 类提供了多种用于字符串匹配和查找的方法，这些方法底层经过高度优化，适用于绝大多数业务场景。因此，理解这些方法的使用方式和区别，是写出高质量 Java 代码的重要基础。

## 二、使用 contains() 方法判断子串

在 Java 中，判断字符串是否包含某个子串最简单直接的方法就是使用 contains()。该方法属于 String 类，返回布尔值。

示例代码：

```java
String str = "Hello Java World";
boolean result = str.contains("Java");
System.out.println(result); // true
```

contains() 方法本质上是通过 indexOf() 实现的，其源码中调用了 indexOf() >= 0 作为判断条件。因此，在性能上二者几乎没有差别。

使用 contains() 的优势在于语义清晰，代码可读性强。当需求只是判断“是否包含”而不关心具体位置时，优先使用 contains() 更加直观。这种方式特别适合初学者和团队协作环境中保持代码一致性。

需要注意的是，contains() 是区分大小写的。如果需要忽略大小写判断，则需要结合 toLowerCase() 或 toUpperCase() 进行处理，例如：

```java
str.toLowerCase().contains("java".toLowerCase());
```

## 三、使用 indexOf() 方法判断子串

如果除了判断是否包含子串外，还需要获取子串在原字符串中的位置，那么 indexOf() 方法更为合适。

示例代码：

```java
String str = "Hello Java World";
int index = str.indexOf("Java");
if (index != -1) {
    System.out.println("包含子串，位置为：" + index);
}
```

indexOf() 返回子串第一次出现的位置，如果未找到则返回 -1。相比 contains()，它的功能更强大。

在需要多次查找的场景中，还可以结合循环与第二个参数 fromIndex 使用，例如：

```java
int index = str.indexOf("a", 5);
```

这种方式在进行批量字符串匹配时更加灵活。

根据 OpenJDK 源码实现（OpenJDK, 2023），indexOf() 底层采用字符数组遍历方式进行匹配，在大多数场景下具有良好的性能表现。因此，在性能要求较高的系统中，合理使用 indexOf() 依然是主流做法。

## 四、使用 matches() 方法进行正则匹配

当判断逻辑较为复杂，例如需要判断是否包含某种模式（如手机号、邮箱格式等），可以使用 matches() 方法。

示例代码：

```java
String str = "My phone is 13812345678";
boolean result = str.matches(".*\\d{11}.*");
System.out.println(result);
```

matches() 方法的特点是使用正则表达式进行整体匹配。需要注意的是，它要求整个字符串匹配，因此通常需要在前后加上 ".*"。

正则匹配功能强大，但性能相对较低。特别是在高并发或大数据量场景下，应谨慎使用。对于简单的包含判断，不建议使用正则。

## 五、不同方法对比分析

下表对 Java 判断字符串是否包含子串的常见方法进行对比：

| 方法名称     | 返回类型 | 是否支持正则 | 是否区分大小写 | 性能表现 | 适用场景 |
|--------------|----------|--------------|----------------|----------|----------|
| contains()   | boolean  | 否           | 是             | 高       | 简单包含判断 |
| indexOf()    | int      | 否           | 是             | 高       | 需要获取位置 |
| matches()    | boolean  | 是           | 是             | 中等偏低 | 复杂模式匹配 |
| Pattern/Matcher | boolean | 是         | 可配置         | 中等     | 高级正则需求 |

从表格可以看出，**在绝大多数普通业务中，contains() 和 indexOf() 是更高效、更推荐的方式**。只有在涉及复杂规则匹配时，才应考虑使用正则表达式。

## 六、忽略大小写的子串判断方法

Java 默认字符串匹配是区分大小写的，但在某些业务场景中需要忽略大小写。例如搜索功能、关键词匹配等。

常见方式是统一转换大小写：

```java
str.toLowerCase().contains(sub.toLowerCase());
```

这种方法简单直接，但会产生新的字符串对象。在大规模文本处理中可能带来一定内存消耗。

更高级的方式是使用 Pattern 并设置 CASE_INSENSITIVE 标志：

```java
Pattern pattern = Pattern.compile("java", Pattern.CASE_INSENSITIVE);
Matcher matcher = pattern.matcher(str);
boolean found = matcher.find();
```

这种方式在复杂匹配场景下更加灵活，也便于扩展。

## 七、大数据场景下的性能优化建议

在处理大文本或高频字符串匹配时，性能成为关键因素。根据《Effective Java》（Joshua Bloch, 2018）建议，应优先选择简单、明确的 API，避免不必要的正则匹配。

如果是在海量数据中查找多个关键词，可以考虑以下策略：

首先，减少字符串重复创建；其次，合理利用缓存；再次，避免频繁使用 matches()。

在实际项目中，如果涉及到日志分析或批量文本处理，往往需要结合多线程与批处理机制。在研发团队协作中，可以借助研发项目管理系统如 [PingCode](https://PingCode.com?utm_source=insights&utm_medium=%E5%93%81%E7%89%8C%E8%AF%8D) 对字符串处理模块进行版本追踪与性能优化记录，提升协作效率与代码质量。

## 八、常见错误与注意事项

在使用 Java 判断字符串是否包含子串时，常见错误包括空指针异常和编码问题。

例如：

```java
String str = null;
str.contains("Java"); // 抛出 NullPointerException
```

因此，在实际开发中应先进行非空判断：

```java
if (str != null && str.contains("Java")) {
    ...
}
```

另外，在处理多语言字符或特殊编码时，应确保字符串编码一致，否则可能出现匹配失败的问题。

对于高并发系统，建议避免在循环中重复创建正则对象，应提前编译 Pattern，以减少性能损耗。

## 九、总结与未来趋势

综上所述，Java 判断字符串是否有子串主要依赖 contains()、indexOf() 和 matches() 三种方式。**在简单场景中优先选择 contains()，在需要位置信息时选择 indexOf()，在复杂规则匹配时使用正则表达式。**

随着 Java 版本不断升级，字符串处理性能也在持续优化。例如 Java 9 引入紧凑字符串（Compact Strings）机制，提高了内存利用率。在未来，高性能文本处理可能会结合并行流与更高效的底层算法实现。

对于开发者而言，掌握字符串包含判断的不同方法及其适用场景，是提升代码质量的重要基础。合理选择工具和方法，既能保证程序正确性，也能提升系统整体性能。

参考与资料来源  
Oracle Java Documentation, String Class API, 2023  
OpenJDK Source Code, String.indexOf Implementation, 2023  
Joshua Bloch, Effective Java (3rd Edition), 2018

Java提供了String类的contains方法，可以直接判断一个字符串是否包含指定的子串。比如，str.contains(subStr)会返回一个布尔值，表示str是否包含subStr。

使用String类的contains方法判断子串

我想知道在Java编程中有什么方法可以判断一个字符串是否包含另一个子字符串？

如何在Java中检查一个字符串是否包含指定的子串？

可以使用String类的indexOf方法，例如str.indexOf(subStr)会返回子字符串subStr在字符串str中首次出现的位置索引。如果返回-1，表示子串不存在。

利用indexOf方法获取子串位置

除了判断是否存在，我还想知道如何获取子字符串在父字符串中的位置索引。

有什么方法可以找到子串在字符串中的起始位置？

一种常用做法是将两个字符串都转换成统一的大小写（例如转成小写），然后使用contains方法。例如，str.toLowerCase().contains(subStr.toLowerCase())，这样可以忽略大小写进行判断。

转换字符串后使用contains方法进行忽略大小写判断

我想判断字符串中是否包含某个子串，但不区分大小写，应该怎么实现？

如何处理大小写匹配问题，在判断子串时忽略大小写？

PingCodeDocs

Java判断字符串是否包含子串，常用方法包括contains()、indexOf()和matches()。contains()适用于简单包含判断，indexOf()可获取子串位置，matches()适用于基于正则表达式的复杂匹配场景。不同方法在性能和适用场景上存在差异，开发中应根据业务需求合理选择，同时注意大小写处理、空指针校验及性能优化问题，以提升代码质量与系统效率。

Java判断字符串中是否有子串