Redis ZREVRANGE 怎样按分数倒序读取有序集合

Redis 的有序集合想按分数从高到低读取成员，可以使用 ZREVRANGE key start stop [WITHSCORES]。其中排名从 0 开始，stop 是包含在结果里的；如果要读取全部成员，最常见的写法是 ZREVRANGE key 0 -1。如果是新代码，Redis 6.2 之后更推荐用 ZRANGE key start stop REV [WITHSCORES] 表达同样的倒序读取意图。

官方地址：https://redis.io/docs/latest/commands/zrevrange/

记住三个重点：分数越大越靠前；start 和 stop 按倒序排名计算且两端都包含；WITHSCORES 会把每个成员对应的分数一起返回。

一、ZREVRANGE 的参数怎样理解

ZREVRANGE 的基本语法如下：

# 中文注释：按倒序排名读取一个有序集合的闭区间
ZREVRANGE key start stop

# 中文注释：在成员名后同时返回每个成员的分数
ZREVRANGE key start stop WITHSCORES

key 是有序集合的键，start 和 stop 是排名索引。倒序结果的第一个成员排名为 0，排名越靠前代表分数越高。stop 不是排他边界，所以读取前三名要写成 0 2，不是 0 3。

这个命令只读取数据，不会改变有序集合。Redis 官方给出的时间复杂度是 O(log(N)+M)，其中 N 是集合元素数量，M 是返回的成员数量。

二、先用一个最小数据集看结果

下面先创建三个分数不同的成员，再从最高分读到最低分。命令块中的注释说明每一步用途，便于直接改成自己的键名。

# 中文注释：清理旧键，避免上一次实验的成员影响结果
redis-cli DEL leaderboard

# 中文注释：写入三个成员，分数越大，倒序排名越靠前
redis-cli ZADD leaderboard 72 "alice"
redis-cli ZADD leaderboard 95 "bob"
redis-cli ZADD leaderboard 84 "carol"

# 中文注释：0 到 -1 表示从最高分成员读到最低分成员
redis-cli ZREVRANGE leaderboard 0 -1

返回结果的顺序应当是 bob、carol、alice。这里的顺序不是按成员名字排序，而是先比较 score，再按倒序排名输出。

1) "bob"
2) "carol"
3) "alice"

三、start 和 stop 怎样读取指定排名

因为排名从 0 开始，并且两端都包含，所以常见写法可以这样记：

负索引从结果末尾倒数：-1 是最后一个成员，-2 是倒数第二个成员。索引超出集合范围时，Redis 会把它限制在有效范围内；如果调整后的范围没有成员，返回空数组。

# 中文注释：只读取最高分的前三名，stop=2 仍然会包含第三名
redis-cli ZREVRANGE leaderboard 0 2

# 中文注释：从倒序结果末尾读取最后两个成员
redis-cli ZREVRANGE leaderboard -2 -1

四、WITHSCORES 返回的不是普通成员列表

需要在展示排行榜时同时知道成员和分数，可以加上 WITHSCORES：

# 中文注释：读取前三名，并把每个成员的 score 一起返回
redis-cli ZREVRANGE leaderboard 0 2 WITHSCORES

结果会以“成员、分数、成员、分数”的数组形态出现：

1) "bob"
2) "95"
3) "carol"
4) "84"
5) "alice"
6) "72"

接入客户端时要按相邻两个元素组成一对，不能把偶数位置的分数当成下一个成员。不同客户端可能会把它封装成数组、键值对象或带 score 的结构，但服务端表达的都是成员与分数的对应关系。

五、分数相同时按什么顺序排列

如果多个成员的 score 相同，ZREVRANGE 会使用倒序字典序排列这些成员。因此，业务上想要稳定的排行榜时，不要只观察分数；同分成员的名字也会影响最终顺序。

# 中文注释：写入同分成员，用来观察同分时的字典序规则
redis-cli ZADD leaderboard 90 "anna" 90 "zoe" 90 "mike"

# 中文注释：读取同分成员，结果会先按分数，再按倒序字典序排列
redis-cli ZREVRANGE leaderboard 0 -1 WITHSCORES

这也是为什么不能把 ZREVRANGE 的结果简单理解成“按写入先后返回”。有序集合的排序依据是 score 和同分时的成员字典序，不是最近写入顺序。

六、新代码为什么要考虑 ZRANGE REV

Redis 官方文档把 ZREVRANGE 标记为自 6.2.0 起 deprecated，新代码可以把它改写为 ZRANGE 加 REV。两者都按排名范围读取成员，迁移时主要是把命令名和参数位置换成新的语法：

# 中文注释：旧写法，读取倒序排名 0 到 2，并返回分数
redis-cli ZREVRANGE leaderboard 0 2 WITHSCORES

# 中文注释：新写法，用 REV 表达倒序，结果语义保持一致
redis-cli ZRANGE leaderboard 0 2 REV WITHSCORES

不要把 REV 和 BYSCORE 混为一谈。本文标题对应的是按排名读取；如果需求是按分数区间筛选，需要使用 ZRANGE 的 BYSCORE 形式，并重新确认 start、stop 的含义。

七、常见问题

为什么 ZREVRANGE 读不到我刚写入的成员？

先检查写入的 key 是否和读取的 key 完全一致，再用 ZSCORE 或 ZCARD 确认成员是否确实存在。空数组也可能是范围在调整后没有覆盖任何有效排名。

读取前十名应该写 0 9 还是 0 10？

应该写 0 9，因为 start 和 stop 都包含，排名 0 到 9 正好是十个成员。

WITHSCORES 能不能只返回分数？

不能。WITHSCORES 返回成员及其分数的配对结果；如果只需要某个成员的分数，应使用 ZSCORE。

新项目还可以继续使用 ZREVRANGE 吗？

兼容已有代码时可以继续理解和维护它；新代码更适合使用 ZRANGE ... REV，这样正序和倒序读取统一在同一个命令族中。

总结

ZREVRANGE 适合按有序集合的倒序排名读取成员：score 越大越靠前，start 和 stop 是从 0 开始的闭区间，负索引从结果尾部计算，WITHSCORES 用于同时取回成员和分数。遇到同分成员时要记住倒序字典序；面向 Redis 6.2 及之后的新代码，则优先考虑 ZRANGE ... REV。