$indexOfBytes（按字节查找子串位置）

最后更新：2026-10-09

$indexOfBytes（按字节查找子串位置）

$indexOfBytes 返回子串在字符串中首次出现的 UTF-8 字节位置，找不到返回 -1。可指定 start 和 end 限定搜索范围。字节位置与码点位置在多字节字符下不一致：中文等字符占多字节，字节索引可能指向字符中间，处理用户可见文本时建议用 $indexOfCP。任一参数为 null 时返回 null。

📝 语法

{ $indexOfBytes: [ <字符串表达式>, <子串>, <起始位置>, <结束位置> ] }

⚙️ 参数

返回值：字节位置（从 0 起）；找不到返回 -1；任一参数为 null 时返回 null。

▶ 示例

请在本地安装的 mongosh 中执行以下命令（需已启动 mongod）：

// $indexOfBytes：定位 ERROR 在日志中的位置
 db.logs.aggregate([
  { $project: { pos: { $indexOfBytes: [ '$msg', 'ERROR' ] } } }
])

运行结果：

{ "_id": 1, "pos": 12 }
{ "_id": 2, "pos": -1 }

📌 注意事项

• 从 0 开始计数；找不到返回 -1
• 中文场景字节索引与字符索引不同，用 $indexOfCP 更直观
• start/end 也按字节计算

🏷️ 相关标签

💡 相关案例

📚 相关教程

❓ 常见问题

Web-Tutorial 技术团队

由多位开发者共同维护的编程教程平台。每篇教程由对应领域的开发者编写和审核，确保内容准确可靠。如发现任何问题，欢迎向我们反馈。

关于我们