如何在 Java 中利用 String.indexOf() 快速定位特定字符在文本中首次出现的位置索引

在Ja va里处理字符串时，经常需要快速定位某个特定字符。这时候，String.indexOf() 方法往往是最高效、最直接的选择。它返回一个int类型的索引值：如果找到了目标字符，就返回其首次出现的位置（从0开始计数）；如果没找到，则返回 -1。整个过程无需手动遍历，也无需动用正则表达式，一行代码就能搞定。

基础用法：查单个字符

最基本的调用方式是 str.indexOf(ch)，这里的 ch 必须是 char 类型，比如 'a'、' ' 或 '@'。

• 搜索是区分大小写的。例如，"Abc".indexOf('a') 会返回 -1，而 "Abc".indexOf('A') 则返回 0。
• 如果对空字符串 "" 调用该方法，结果始终是 -1。

进阶技巧：从指定位置开始搜索

如果想跳过字符串的开头部分，或者寻找字符第二次出现的位置，可以使用重载方法 str.indexOf(ch, fromIndex)。

• fromIndex 参数指定了搜索的起始下标（包含该位置）。它必须大于等于0；如果大于等于字符串长度，方法会直接返回 -1。
• 一个典型的应用场景是查找第二个 'e'：先通过 int first = s.indexOf('e'); 找到第一次出现的位置，然后调用 int second = s.indexOf('e', first + 1); 从第一次出现之后开始找。
• 为了避免越界错误，建议在调用第二次搜索前，先检查 first 是否不等于 -1。

常见误区与注意事项

这个方法语法简单，但有些语义上的细节容易出错：

• 注意不要误传字符串参数（如 "a"）。这实际上会调用 indexOf(String) 重载，虽然功能相似，但性能略低，且容易造成混淆。
• 牢记索引是从 0 开始的。例如，"hello".indexOf('h') 返回的是 0，而不是 1。
• 如果字符串本身为 null，调用该方法会抛出 NullPointerException。因此，使用前的判空检查是必要的。
• 对于中文、Emoji 等 Unicode 字符，该方法同样适用。因为 Ja va 中的 char 类型代表一个 UTF-16 编码单元，对于基本多文种平面（BMP）内的字符，定位是完全准确的。

实用小示例：提取邮箱用户名

一个常见的需求是从邮箱地址中提取 @ 符号之前的部分。利用 indexOf() 可以轻松实现：

• String email = "user@example.com";
• int atPos = email.indexOf('@');
• String user = (atPos != -1) ? email.substring(0, atPos) : "";