$setUnion（集合并集）
最后更新：2026-10-09
$setUnion（集合并集）
$setUnion 返回两个或多个数组的并集，自动去重，元素顺序不保证，是集合表达式，常用于 $project 与 $addFields；从 MongoDB 8.1 起也可作为 $group 的累加器使用。与 $concatArrays 不同，它去重且视为集合运算。适合合并标签、权限列表。
| 分类 | 累加器 |
|---|---|
| MongoDB 版本 | 1.0+ |
| 示例语言 | mongosh (Shell) |
📝 语法
{ $setUnion: [ <数组1>, <数组2>, ... ] }返回值：所有输入数组的并集（去重，顺序不保证）
▶ 示例
请在本地安装的 mongosh 中执行以下命令（需已启动 mongod）：
// $setUnion：合并两个标签数组并去重
db.products.aggregate([
{ $project: { allTags: { $setUnion: ['$tags', ['hot']] } } }
])运行结果：
// 已存在的标签不重复出现📌 注意事项
- 自动去重，结果是无重复的集合
- 元素顺序不保证
- MongoDB 8.1 起可作为 $group 累加器
🏷️ 相关标签
💡 相关案例
更多实战案例即将上线，敬请期待。
📚 相关教程
❓ 常见问题
Q$setUnion 和 $concatArrays 有什么区别？
A$setUnion 去重且顺序不保证；$concatArrays 保留全部元素和顺序。
Q输入必须是数组吗？
A是，所有输入都必须是数组，否则报错。
Q能在 $group 里当累加器用吗？
AMongoDB 8.1 起可以，合并组内文档的集合字段。
