Redis的有序集合（sorted set）通过给每个成员关联一个分数，实现了按分值排序与区间检索的能力。ZRANGEBYSCORE正是专门用来根据分数范围取出成员列表的命令，在积分排行、定时任务、优先级队列等场景中非常实用。
一、ZRANGEBYSCORE基础语法与参数含义
命令的基本格式为：ZRANGEBYSCORE key min max [WITHSCORES] [LIMIT offset count]。其中key是有序集合的名称，min和max分别代表分数区间的下限与上限。默认情况下，min和max都是闭区间，即包含等于该值的成员。例如ZRANGEBYSCORE rank 10 20会返回分数在10到20之间（含10和20）的所有用户。
如果需要排除边界值，可以在数字前加左括号表示开区间。比如ZRANGEBYSCORE rank (10 (20就只取分数大于10且小于20的成员。此外，Redis支持用-inf和+inf表示负无穷和正无穷，方便查询某一侧无边界的范围，如ZRANGEBYSCORE rank 0 +inf就是取出所有分数不小于0的成员。WITHSCORES选项会让结果一并返回分数，便于业务侧做展示或二次处理。
二、LIMIT参数在分页查询中的用法
当有序集合成员非常多时，直接拉取一个宽分数区间可能造成网络传输和内存压力。LIMIT参数与普通SQL里的limit类似，接收offset和count两个值，用来跳过前offset个结果，并最多返回count个成员。例如ZRANGEBYSCORE rank 0 100 LIMIT 10 5，表示在0到100分之间，跳过前10名，取接下来的5名。
需要注意的是，Redis在执行时会先找到区间内所有元素再应用偏移，因此offset很大时依然会遍历较多内部节点。如果要做深分页，更好的做法是结合上一次查询的最大分数，用开区间作为下一页的min，从而避免大offset。例如第一页取到分数20，第二页可用ZRANGEBYSCORE rank (20 100 LIMIT 0 5，这样效率更高且数据不重不漏。
三、闭区间与开区间的正确书写
很多线上问题源于边界符号写错。闭区间直接写数字，开区间加英文左括号。下表列出常见写法及其含义，方便对照：
| 写法示例 | 含义说明 |
|---|---|
| ZRANGEBYSCORE k 5 10 | 分数大于等于5且小于等于10 |
| ZRANGEBYSCORE k (5 10 | 分数大于5且小于等于10 |
| ZRANGEBYSCORE k 5 (10 | 分数大于等于5且小于10 |
| ZRANGEBYSCORE k (5 (10 | 分数大于5且小于10 |
在定时任务场景里，我们常取分数小于当前时间戳的任务来执行，此时应写ZRANGEBYSCORE tasks -inf (1700000000，用开区间排除正好等于边界的脏数据，防止重复消费。明确区间开闭，是保障业务逻辑准确的基础。
四、性能注意点与优化建议
ZRANGEBYSCORE底层基于跳表与字典实现，按分数查区间的时间复杂度是O(log(N)+M)，M为返回元素数。若区间很宽且不加LIMIT，M可能接近全量，会造成阻塞。因此在生产环境务必对大区间查询做count限制，或拆成多次小区间扫描。
另外，如果业务只需要成员名不需要分数，就别带WITHSCORES，减少序列化开销。对于超大规模排行，可考虑按分数段拆分多个key，或用ZSCAN游标逐步遍历。监控方面，留意slowlog里出现的ZRANGEBYSCORE记录，及时调整调用参数，避免拖慢整个Redis实例。
五、典型应用案例
以游戏积分为例，游戏公司用zset保存玩家分数，要发周榜奖励给分数在1000到2000的玩家，直接执行ZRANGEBYSCORE game_rank 1000 2000 WITHSCORES即可拿到名单。若只发前50名，则追加LIMIT 0 50。
另一个案例是延时消息队列，把执行时间作为分数，生产者用ZADD写入，消费者用ZRANGEBYSCORE job_queue -inf 当前时间 LIMIT 0 10取出到期任务处理。这种写法简单清晰，并且借助Redis持久化能兼顾性能与可靠性，是中小型系统常用的轻量方案。
RedisZRANGEBYSCORE有序集合修改时间：2026-08-11 08:36:31