Redis里怎么快速查列表长度，llen命令简单用法分享

主要基于Redis官方文档的命令说明和常见的Redis使用教程中的解释）

直接回答你的问题：在Redis里，要快速查看一个列表（List）数据类型的长度，也就是这个列表里面包含了多少个元素，你只需要使用一个非常简单的命令，叫做 LLEN，这个命令的名字其实就是“List LENgth”的缩写，非常直观，它的速度极快，是常数时间复杂度，这意味着无论你的列表是只有几个元素，还是成百上千万个元素，LLEN 命令返回结果所花费的时间基本是一样的，所以完全不用担心性能问题。

我们来详细分享一下 LLEN 命令的简单用法。

命令的基本语法

LLEN 命令的语法简单到不能再简单了，它只需要一个参数，格式是这样的：

LLEN key

这里唯一的 key 就是你想要查看长度的那个列表的名字，你有一个列表，它的键（key）叫 “mytodo”（我的待办事项），那么你想知道里面有几项待办，就在Redis客户端里输入 LLEN mytodo，然后回车就行了。

命令的返回值

当你执行 LLEN 命令后，Redis会返回一个整数（integer）类型的值，这个值就代表了指定列表中的元素数量。

这里主要有两种情况：

1. 列表存在时：如果这个键存在，并且它确实是一个列表类型，LLEN 会返回这个列表当前的元素个数，你的“mytodo”列表里有“买菜”、“写报告”、“打电话”三项，LLEN mytodo 就会返回 3。
2. 列表不存在时：如果你输入的 key 在Redis中根本不存在，Redis不会报错，它会很友好地返回一个 0，因为它认为一个不存在的列表，其长度自然就是0，这是一种很合理的设计。
3. 键存在但不是列表类型时：这里需要特别注意一下，如果你指定的 key 是存在的，但它不是列表类型，而是字符串（String）、集合（Set）、哈希（Hash）等其他类型，那么Redis会报一个错误，错误信息大概是 (error) WRONGTYPE Operation against a key holding the wrong kind of value，意思是，你对一个存储了错误类型值的键进行了不当操作，在使用 LLEN 之前，你心里得清楚这个键存的是不是列表。

简单用法实例

让我们通过一些具体的例子来感受一下,假设我们正在使用 redis-cli（Redis命令行界面）进行操作。

例子1：检查一个空列表或不存在的列表

0.0.1:6379> LLEN mynewlist
(integer) 0

这里,mynewlist 这个键可能不存在，或者存在但里面没有任何元素，所以返回了0。

例子2：创建一个列表并检查其长度

0.0.1:6379> LPUSH mylist "first task"  // 使用LPUSH命令从左边插入一个元素 "first task"
(integer) 1  // LPUSH命令返回当前列表长度，现在是1
127.0.0.1:6379> LPUSH mylist "second task" // 再插入一个 "second task"
(integer) 2  // 长度变为2
127.0.0.1:6379> LLEN mylist // 我们使用LLEN命令来查询长度
(integer) 2  // 返回2，和我们预期的一样

例子3：继续添加元素后查询

0.0.1:6379> RPUSH mylist "third task"  // 使用RPUSH命令从右边插入 "third task"
(integer) 3  // 长度变为3
127.0.0.1:6379> LLEN mylist
(integer) 3

例子4：尝试对非列表类型的键使用LLEN（错误示范）

0.0.1:6379> SET mykey "hello"  // 设置一个字符串类型的键值对
OK
127.0.0.1:6379> LLEN mykey  // 错误地试图获取字符串的长度
(error) WRONGTYPE Operation against a key holding the wrong kind of value

LLEN为什么这么快？以及一些使用场景提示

就像开头提到的,LLEN 命令非常快，根据Redis官方文档的解释，这是因为Redis在内部存储列表数据结构时，已经实时维护了一个变量来记录列表的长度，所以当执行 LLEN 时，Redis不需要去遍历整个列表一个个地数元素，它直接把这个现成的长度值返回给你就行了，这种设计理念使得Redis在处理大规模数据时依然能保持高性能。

基于这个特性,LLEN 命令在一些场景下特别有用：

• 判断列表是否存在或是否为空：如果你需要先判断一个列表里有没有东西，再决定后续操作（比如要不要从里面弹出元素），直接 LLEN key 看看结果是不是大于0就行了，这比尝试弹出元素再处理要安全。
• 监控和统计：你可以用 LLEN 来实时查看消息队列中有多少条消息等待处理，或者查看用户操作日志列表积累了多少条记录，方便进行监控告警。
• 分页显示：如果你用列表来存储一些ID之类的数据，并需要做分页展示，LLEN 可以帮你快速计算出总页数。

总结一下：

LLEN key 是Redis中用于获取列表长度的专属命令，它用法极其简单，速度极快，你只需要记住，给它一个正确的列表类型的键，它就会立刻告诉你里面有多少个元素，在使用中，注意区分键不存在（返回0）和键是其他类型（返回错误）这两种情况就好，这是一个在日常使用Redis列表时一定会频繁用到的基础命令。