$substrBytes（按字节提取子串）

最后更新：2026-10-09

$substrBytes（按字节提取子串）

$substrBytes 按 UTF-8 字节位置提取子串，位置和长度都以字节为单位。它适合处理纯 ASCII 文本（字节数等于字符数）或需要精确控制存储大小时使用。注意对中文等多字节字符，字节位置可能落在字符中间产生乱码，此时应改用按码点计数的 $substrCP。start 为负数返回空字符串，length 为负数返回剩余全部。

📝 语法

{ $substrBytes: [ <字符串表达式>, <字节起始位置>, <字节长度> ] }

⚙️ 参数

返回值：提取的子串；任一参数为 null 时返回 null。

▶ 示例

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

// $substrBytes：取文档内容前 10 字节
 db.files.aggregate([
  { $project: { head: { $substrBytes: [ '$content', 0, 10 ] } } }
])

运行结果：

{ "_id": 1, "head": "hello wor" }
{ "_id": 2, "head": "MongoDB su" }

📌 注意事项

• 中文一个字符占 3 个 UTF-8 字节，按字节截取可能截到半个字
• start 为负数返回空字符串，length 为负数返回剩余全部
• 纯英文场景结果与 $substrCP 一致

🏷️ 相关标签

💡 相关案例

📚 相关教程

❓ 常见问题

Web-Tutorial 技术团队

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

关于我们