indexof返回索引(≥0或-1),用于定位;includes返回布尔值(true/false),专用于存在性判断;二者语义、用途、返回值不同,不可互换,且includes对nan和undefined处理更准确。

indexOf 问“在哪儿”,includes 问“有没有”——这是最核心的区别。二者用途不同、返回值不同、语义不同,不能简单互换。
返回值与使用场景完全不同
indexOf 返回数字:找到时是索引(≥0),没找到是 -1;适合需要定位、截取或后续操作的场景,比如 str.substring(0, str.indexOf(' ')) 获取首空格前内容。
includes 返回布尔值:true 或 false;专为存在性判断设计,比如权限校验、关键词过滤、条件分支:if (str.includes('admin')) { ... }。
常见错误:直接用 if (str.indexOf('x')) 判断——当子串在开头(索引为 0)时,条件为假,逻辑出错。正确写法必须是 if (str.indexOf('x') !== -1)。
对特殊值的处理能力有差异
NaN 是典型例子:
• [NaN].indexOf(NaN) 返回 -1(因为 NaN === NaN 为 false)
• [NaN].includes(NaN) 返回 true(includes 内部做了专门处理)
undefined 同理:includes 能准确识别数组中的 undefined 元素,indexOf 在稀疏数组中可能表现不稳定。
对于 -0 和 +0,两者都视为相等,无区别。
大小写与参数行为细节
两者都区分大小写('A'.includes('a') 为 false),不存在“includes 不区分大小写”的说法——那是常见误解。
都支持起始位置参数(第二个参数):
• str.indexOf('x', 3):从索引 3 开始找,返回匹配位置(可能 ≥3)
• str.includes('x', 3):从索引 3 开始检查是否包含,不改变“是否存在”的结论,只缩小搜索范围
兼容性与现代推荐用法
indexOf 兼容所有浏览器(包括 IE6+);includes 是 ES2015 标准,IE 完全不支持,需 polyfill 或构建工具转译。
性能上几乎没有实际差别:includes 底层基本复用 indexOf 实现,仅多一次 !== -1 判断,耗时差异在纳秒级,远低于一次 DOM 操作或正则开销。
选型原则很明确:
• 只需判断“有没有” → 用 includes(更安全、意图清晰)
• 需要知道“从哪开始”或要配合 slice/replace/substring 使用 → 必须用 indexOf
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南











