命令语法与排名规则解析
ZREMRANGEBYRANK 的命令格式是 ZREMRANGEBYRANK key start stop，其中 key 是有序集合的键名，start 和 stop 是排名索引，并且都包含在删除范围内。排名索引从 0 开始，即最小分数的成员排在位置 0，分数越大排名越靠后。如果分数相同，Redis 会按照成员字典序升序排列，这一点需要特别注意：ZREMRANGEBYRANK 在遇到相同分数时并不是随机排序，而是按成员字符串的二进制比较结果排序。
start 和 stop 参数可以使用负数，-1 表示最后一个成员，-2 表示倒数第二个，以此类推。这意味着你可以用 ZREMRANGEBYRANK key 0 -1 清空整个有序集合，等效于 DEL key 但不完全一样，因为该命令会返回删除成员数量而 DEL 只返回 1。如果 start 大于 stop，或者 start 大于集合最大索引，命令会返回 0，不执行任何删除。如果 start 小于 0，会被当作 0 处理；如果 stop 大于最大索引，会被当作最大索引处理。
举个例子：假设有一个排行榜数据，分数从低到高存储了 100 个用户。执行 ZREMRANGEBYRANK rank:2025 0 49 会删除前 50 名分数最低的成员，保留分数最高的 50 名。反过来 ZREMRANGEBYRANK rank:2025 -10 -1 则删除最后 10 名高分成员。返回值为被删除成员数量，例如前者返回 50。
底层实现：跳跃表与区间删除机制
Redis 的有序集合在成员数量较多或单个成员长度较大时，内部使用跳跃表（skiplist）加哈希表（dict）的结构存储。哈希表用于 O(1) 查找成员分数，跳跃表用于按分数和字典序维护排序。ZREMRANGEBYRANK 的核心逻辑是：调用 zslGetElementByRank 函数从跳跃表头节点开始，通过 rank 快速定位到起始索引对应的节点，然后从该节点开始向后遍历，直到超过 stop 索引或链表末尾，逐个删除节点并同步更新哈希表中的映射。
查找起始节点的复杂度是 O(log N)，因为跳跃表每一层都有索引，可以跳过大量节点。但删除 M 个成员时，需要遍历这 M 个节点，并在跳跃表和哈希表中分别执行删除操作，所以总复杂度是 O(log N + M)。如果 M 接近 N，复杂度退化为 O(N)。删除过程中还会更新跳跃表的层高，但不会触发重平衡操作，因为跳跃表本身是概率性结构，不需要像红黑树那样旋转。
有一个容易忽略的细节：删除操作会同时释放成员字符串和分数占用的内存。如果成员是长字符串，并且删除数量巨大，可能会产生大量内存碎片。Redis 的内存分配器 jemalloc 对小块内存有缓存，但频繁删除可能导致内存碎片率上升。对于需要批量清理的场景，建议使用 UNLINK 异步删除，但 ZREMRANGEBYRANK 本身是同步命令，如果担心阻塞，可以用 ZREMRANGEBYRANK 配合分片删除，每次只删除一小部分。
# 创建一个测试有序集合 ZADD scoreboard 100 "alice" 95 "bob" 88 "carol" 75 "dave" 70 "eve" # 查看当前排名（索引 0 是分数最低的 dave 或 eve，因为分数最低的是 eve 70） ZRANGE scoreboard 0 -1 WITHSCORES # 执行按排名删除：删除索引 0 到 1，即删除分数最低的两位成员 ZREMRANGEBYRANK scoreboard 0 1 # 返回 2，剩余成员为 alice, bob, carol
上面的例子中，分数 70 的 eve 排在索引 0，75 的 dave 排在索引 1，删除后剩余三个成员。注意当分数相同时，比如两个成员都是 100 分，则按成员名字典序排列，名字小的排前面。
实战场景与性能避坑指南
ZREMRANGEBYRANK 最常见的场景是维护固定长度的排行榜。例如每日活跃榜只需要保留前 100 名，当新数据插入后，可以执行 ZREMRANGEBYRANK active:2025-04-15 100 -1 来删除排名 100 之后的成员。由于索引从 0 开始，100 表示第 101 个成员，所以删除 100 到 -1 能精确保留前 100 名。如果执行时机不对，比如在插入一条新记录之前就删除了，可能会误删第 100 名，因此推荐先 ZADD 再 ZREMRANGEBYRANK。
另一个典型场景是清理过期日志数据。有序集合按时间戳作为分数存储日志 ID，每天定时删除 30 天前的数据。可以先用 ZRANGEBYSCORE 查出最早的时间戳，然后转换成分数判断排名区间，再用 ZREMRANGEBYRANK 删除。但更直接的做法是使用 ZREMRANGEBYSCORE 按分数删除，因为分数即时间戳，排名区间反而不直观。不过如果你的需求是保留最新的 N 条记录，ZREMRANGEBYRANK 0 -N-1 是最简单的写法，其中 N 是要保留的数量。
性能方面要特别注意：如果有序集合非常大，例如百万级，执行 ZREMRANGEBYRANK 0 -1000000 会一次性删除全部成员，阻塞 Redis 主线程数百毫秒，影响其他请求。生产环境建议将大范围删除拆分成多个小范围操作，每次删除几百到几千个成员，并在客户端循环执行，期间插入 sleep 或使用异步任务队列。另外，Redis 6.2 及以上版本支持 ZREMRANGEBYRANK 的阻塞时间监控，可以通过 SLOWLOG 查看执行耗时，结合 MEMORY USAGE 观察内存释放情况。
还有一个冷门技巧：ZREMRANGEBYRANK 可以用来实现“随机抽取并移除”。比如一个抽奖池存了 1000 个用户，随机生成一个排名索引，然后删除该索引位置的一个成员。这比 SPOP 更适合有序集合，因为 SPOP 只针对 Set 类型。不过要注意生成的随机索引不能越界，且每次删除后索引会变化，需要重新计算集合大小。
RedisZREMRANGEBYRANK有序集合修改时间：2026-09-18 13:49:15