$bitsAnySet（任一位被设置）
最后更新：2026-10-09
$bitsAnySet（任一位被设置）
$bitsAnySet 匹配数值字段中给定位置至少有一位为 1 的文档。`{ flags: { $bitsAnySet: 12 } }`（12 的二进制为 1100）匹配第 2 位或第 3 位任一为 1 的文档。适合「任一权限开启即通过」的判断。仅支持整数与 BinData 字段。
| 分类 | 位运算 |
|---|---|
| MongoDB 版本 | 3.2+ |
| 示例语言 | mongosh (Shell) |
📝 语法
{ <字段>: { $bitsAnySet: <位掩码或位置数组> } }⚙️ 参数
| 字段 | 要匹配的整数或 BinData 字段名。 |
|---|---|
| 位掩码 | 整数位掩码或位置数组，如 12 或 [2, 3]。 |
返回值：匹配的文档游标
▶ 示例
请在本地安装的 mongosh 中执行以下命令（需已启动 mongod）：
// $bitsAnySet：第 2 位或第 3 位至少一位为 1
// 12 的二进制是 1100
db.users.find({ flags: { $bitsAnySet: 12 } })
// 位置数组写法
db.users.find({ flags: { $bitsAnySet: [2, 3] } })运行结果：
// 返回 flags 第 2 位或第 3 位任一为 1 的用户📌 注意事项
- 与 $bitsAllSet 区别：只要有任一位为 1 即匹配
- 适合权限「任一开通」场景
- 只支持 int、long、BinData
🏷️ 相关标签
💡 相关案例
更多实战案例即将上线，敬请期待。
📚 相关教程
❓ 常见问题
Q$bitsAnySet 适合什么场景？
A判断「任一标志位开启」，如用户拥有任一角色权限即通过。
Q$bitsAnySet 和 $bitsAllSet 怎么选？
A任一为 1 用 AnySet，全部为 1 用 AllSet。
Q位置数组与位掩码能混用吗？
A两种形式等价，选其一即可。
