$concatArrays（拼接多个数组）
最后更新：2026-10-09
$concatArrays（拼接多个数组）
$concatArrays 把两个或多个数组合并成一个新数组，常用于把多个标签列表、历史记录或分页数据拼在一起。所有参数都必须解析为数组，任一参数为 null 或缺失时整体返回 null。它不会修改原始文档中的数组，而是返回新的合并结果，适合在 $addFields 或 $project 里组合字段。与字符串版的 $concat 只能拼字符串不同，$concatArrays 只处理数组。
| 分类 | 数组 |
|---|---|
| MongoDB 版本 | 1.0+ |
| 示例语言 | mongosh (Shell) |
📝 语法
{ $concatArrays: [ <数组1>, <数组2>, ... ] }⚙️ 参数
| 数组 | 要合并的数组表达式，至少两个。 |
|---|
返回值：合并后的新数组；任一参数为 null 或缺失时返回 null
▶ 示例
请在本地安装的 mongosh 中执行以下命令（需已启动 mongod）：
// $concatArrays：合并标签和别名
db.products.aggregate([
{ $project: {
allTags: { $concatArrays: ['$tags', '$aliases'] }
} }
])运行结果：
{ '_id': 1, 'allTags': [ 'a', 'b', 'c', 'd' ] }📌 注意事项
- 所有参数必须是数组；字符串需要先 $split 拆成数组或用 $concat 拼接
- 任一参数为 null 则整体返回 null，可用 $ifNull 先兜底
- 返回新数组，原文档数据不受影响
🏷️ 相关标签
💡 相关案例
更多实战案例即将上线，敬请期待。
📚 相关教程
❓ 常见问题
Q$concatArrays 能把字符串拼在一起吗？
A不能，它只接受数组。字符串拼接用 $concat，或先 $split 拆成数组再合并。
Q参数里有 null 会怎样？
A整体返回 null。可用 $ifNull 把 null 替换成空数组。
Q$concatArrays 和 $push 有什么不同？
A$push 是 $group 阶段里累积元素，$concatArrays 是表达式内合并已有数组，用途不同。
