$split（字符串分割）
最后更新：2026-10-09
$split（字符串分割）
$split 按分隔符把字符串拆成子字符串数组，是处理逗号分隔值、标签列表、路径等文本的常用操作符。分隔符必须是非空字符串；若分隔符为空字符串，则按单个字符（码点）拆分。它常与 $arrayElemAt、$size 等数组操作符配合使用。任一参数为 null 或缺失时返回 null。拆分结果可直接用于 $size、$arrayElemAt 等数组操作，灵活度很高。
| 分类 | 字符串 |
|---|---|
| MongoDB 版本 | 1.0+ |
| 示例语言 | mongosh (Shell) |
📝 语法
{ $split: [ <字符串表达式>, <分隔符> ] }⚙️ 参数
| 字符串 | 必填，要拆分的字符串或表达式。 |
|---|---|
| 分隔符 | 必填，非空字符串；空串会按码点拆分。 |
返回值：拆分后的字符串数组；任一参数为 null 时返回 null。
▶ 示例
请在本地安装的 mongosh 中执行以下命令（需已启动 mongod）：
// $split：把逗号分隔的标签拆成数组
db.products.aggregate([
{ $project: { tags: { $split: [ '$tagStr', ',' ] } } }
])运行结果：
{ "_id": 1, "tags": [ "sale", "new", "hot" ] }
{ "_id": 2, "tags": [ "featured" ] }📌 注意事项
- 分隔符为空字符串时按码点拆分，每个字符一个元素
- 分隔符找不到时返回只含原串的数组
- 任一参数为 null 或缺失时返回 null
🏷️ 相关标签
💡 相关案例
更多实战案例即将上线，敬请期待。
📚 相关教程
❓ 常见问题
Q分隔符能是空字符串吗？
A能，空串会按单个字符（码点）拆分。
Q拆完怎么取第一个元素？
A配合 $arrayElemAt 取下标 0 即可。
Q分隔符不存在会怎样？
A返回只含原字符串一个元素的数组。
