$range（生成数字序列）

最后更新：2026-10-09

$range（生成数字序列）

$range 生成从起始值到结束值（不含结束值）的整数序列，可选步长参数。典型场景包括配合 $dateAdd 生成日期序列、为分页生成页码、在测试数据中批量造数。步长默认为 1，可为负实现递减序列；步长为 0 会报错。返回的数组元素都是整数，适合直接喂给 $map 批量生成文档字段。

📝 语法

{ $range: [ <起始>, <结束>, <步长> ] }

⚙️ 参数

返回值：从起始到结束（不含结束）的整数数组

▶ 示例

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

// $range：生成 0 到 4 的编号
db.test.aggregate([
  { $project: {
      nums: { $range: [0, 5] }
  } }
])

运行结果：

{ '_id': 1, 'nums': [ 0, 1, 2, 3, 4 ] }

📌 注意事项

• 结束值不包含在结果里，[0, 5] 生成 0 到 4
• 步长为 0 报错；步长为负时从起始递减
• 常与 $map/$dateAdd 组合生成日期序列或编号序列

🏷️ 相关标签

💡 相关案例

📚 相关教程

❓ 常见问题

Web-Tutorial 技术团队

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

关于我们