在JavaScript里，判断一个字符串是否包含特定的字符或者子串，最基础也最常见的办法就是调用字符串实例上的indexOf()方法。这个方法从设计之初就存在于ECMAScript标准当中，几乎所有运行环境都完整支持，不需要任何垫片。理解它的返回规则和边界情况，能让你在处理用户输入、路由匹配、关键词过滤等场景时写出更可靠的代码。
indexOf()的基本行为
indexOf()接收两个参数，第一个是待查找的子串，第二个是可选的起始搜索位置，默认从下标0开始。它的返回值是一个数字：如果找到了，就返回第一次出现的位置下标；如果没找到，则返回-1。这个设计意味着你不能用布尔值直接接收结果，也不能用if(str.indexOf('a'))来判断，因为当下标为0时，0在布尔上下文里就是false。
下面这段示例展示了最直白的用法，以及一个典型的错误写法：
var str = 'hello world';
// 正确：显式比较是否不等于-1
if (str.indexOf('world') !== -1) {
console.log('包含 world');
}
// 错误：若字符在开头，indexOf返回0，被当成false
if (str.indexOf('hello')) {
console.log('这行不会执行');
}
从上面可以看出，indexOf()的返回值语义是位置而非真假。在只需要知道“在不在”的场景里，必须把结果和-1做严格比较。很多线上bug就是由于用了宽松判断，导致位于首位的关键字被漏掉。
结合起始位置做区间判断
indexOf()的第二个参数允许你跳过前面若干字符再开始找。比如你想确认某个符号是否出现在域名部分之后，就可以传入一个起始下标。当传入负数时，规范会把它当作0处理；传入超过字符串长度的值，则直接返回-1。这个细节在拼接搜索逻辑时非常有用，能避免重复截取字符串。
看一个稍微复杂点的例子，我们要检查查询参数里是否包含某个标记，但只关心问号后面的内容：
var url = 'https://ipipp.com/list?type=1&tag=hot';
var queryStart = url.indexOf('?');
// 从问号之后开始查找
if (url.indexOf('tag=', queryStart) !== -1) {
console.log('存在 tag 参数');
}
这种做法比先slice再indexOf更省内存，也更符合方法原本的意图。需要注意的是，第二个参数只影响起点，不会影响返回值的绝对下标，也就是说返回的下标仍然是相对于整个字符串的。
和includes()、正则的对比
ES6引入了includes()方法，语义上更直观，直接返回布尔值。如果你的运行环境支持ES6，且只关心包含与否，includes()可读性更好。但在需要兼容旧浏览器，或者想知道具体位置以便后续截取时，indexOf()依然是更合适的选择。
| 方法 | 返回值 | 能否拿位置 | 兼容环境 |
|---|---|---|---|
| indexOf() | 数字下标或-1 | 能 | ES5及以下 |
| includes() | 布尔值 | 不能 | ES6及以上 |
| 正则test() | 布尔值 | 不能（需exec） | ES3及以上 |
如果查找规则比较复杂，比如忽略大小写或者匹配模式，正则更合适。但仅判断固定字符或短子串，indexOf()的性能通常更好，也不会因为特殊字符转义问题出错。下面给出忽略大小写时用indexOf的折中写法：
function containsIgnoreCase(src, sub) {
return src.toLowerCase().indexOf(sub.toLowerCase()) !== -1;
}
console.log(containsIgnoreCase('Hello', 'HE')); // true
这种写法在小字符串上完全够用，只是会生成两份小写副本，对超长文本要留意内存占用。
常见误区与避坑
第一个误区是拿indexOf()和空字符串比较。按照规范，indexOf('')永远返回0，因为空串被认为存在于任何位置的开头。如果你用这个来判断“用户是否输入了内容”，就会永远得到真值。第二个误区是混淆了数组的indexOf和字符串的indexOf，二者虽然同名，但数组比较的是全等，字符串比较的是字符序列。
还有一个隐蔽问题：当查找目标和源字符串编码不一致，或者包含组合字符时，indexOf是按UTF-16码元匹配的，某些表情符号或特殊字母可能拆成两个码元，导致匹配不如预期。此时应考虑使用includes配合归一化，或采用更专业的Unicode处理库。
记住一条铁律：用indexOf判断包含，永远写 !== -1，不要偷懒写 != -1 或直接当布尔用。
只要把返回值的数字语义记牢，再注意起始参数和空串边界，indexOf()就是你在JS里做字符串包含判断时最稳的基础工具。
JavaScriptindexOf字符串包含修改时间：2026-08-02 06:24:28