Redis的有序集合（sorted set）把每个成员和一个分数绑定，靠分数排序。ZCOUNT是一条轻量命令，专门用来统计某个分数区间内有多少成员，不涉及取具体元素，因此非常省内存和带宽。
一、ZCOUNT命令基础语法
ZCOUNT的基本调用形式是 ZCOUNT key min max。其中 key 是有序集合的名字，min 是区间下界分数，max 是区间上界分数。命令会扫描该 key 下分数在 min 与 max 之间的成员，并返回个数。由于 Redis 在底层用跳表或压缩列表维护有序集合，统计区间数量时可以借助数据结构的有序性快速定位，一般不需要遍历全部元素。
需要特别注意的是，min 和 max 的写法决定了区间是开还是闭。如果直接写数字，例如 10 20，表示包含 10 和 20 本身；如果想排除边界，要在数字前加左括号，例如 (10 (20 表示大于 10 且小于 20。还支持负无穷 -inf 和正无穷 +inf，用来统计从最低分到某值、或某值到最高分的范围。
二、常见使用场景与示例
假设有一个游戏排行榜，键名是 leaderboard，分数代表玩家积分。想统计积分在 1000 到 5000 之间的玩家数量，可执行 ZCOUNT leaderboard 1000 5000。若只想看高于 1000 但不超过 5000 的，用 ZCOUNT leaderboard (1000 5000。这类统计在运营活动中很常见，比如找出中段活跃用户规模。
再举一个延时任务的例子。用有序集合存任务，分数是执行时间戳。统计当前待执行且在一小时内到期的任务数，可以用 ZCOUNT tasks now (now+3600，其中 now 是当前秒级时间戳。这样无需取出任务内容，就能快速判断队列压力，从而决定是否扩容消费者。
三、边界与特殊参数对照
为了少踩坑，下面把常用边界写法列成表，方便对照。实际开发中建议封装一个函数，把业务里的“大于”“大于等于”映射成对应符号，避免手误。
| 需求描述 | min 写法 | max 写法 | 说明 |
|---|---|---|---|
| 包含上下界 | 10 | 20 | 统计分数 10 到 20 含两端 |
| 排除下界 | (10 | 20 | 大于 10 且小于等于 20 |
| 排除上界 | 10 | (20 | 大于等于 10 且小于 20 |
| 全部成员 | -inf | +inf | 等价于集合基数 |
从表中可以看出，圆括号是控制开闭区间的唯一开关。若 min 比 max 大，Redis 会返回 0，不会报错，所以代码里最好先确认上下界顺序，或在封装层做交换处理。
四、与其他命令的配合
ZCOUNT 常与 ZRANGEBYSCORE 搭配。先用 ZCOUNT 得知区间总量，再做分页：比如每页 50 条，就按页数用 ZRANGEBYSCORE 加 LIMIT 偏移获取。这样能避免一次性拉出海量数据导致客户端阻塞。
另外在监控脚本里，可以把 ZCOUNT 的结果定时上报，观察某些分数段成员数是否异常增长。例如聊天室热度用分数表示消息数，统计超过某热度的房间数，就能快速发现突发流量。配合 ZCARD 看总体量，用两者比值判断分布倾斜情况，对容量规划很有帮助。
五、性能与注意事项
ZCOUNT 的时间复杂度是 O(log(N)+M)，N 是集合成员总数，M 是区间内成员数。因为只需数数，M 只影响遍历区间节点的开销，不返回具体数据，所以比 ZRANGEBYSCORE 更轻。但在成员极多且区间极宽时，仍有一定消耗，应避免在单线程 Redis 里对超大集合频繁执行大范围 ZCOUNT。
还有一点，Redis 集群模式下 key 会分布到不同槽位，ZCOUNT 只能对单个 key 操作，不能跨槽统计。如果业务需要全局区间计数，要么把相关数据放到同一个 hash tag 保证同槽，要么在应用层做汇总。清楚这些边界，才能让统计逻辑既准确又高效。
Redis_ZCOUNT有序集合分数统计分数区间查询修改时间：2026-08-11 23:03:38