当前位置：首页 > news >正文

【Redis篇】 List 列表

news 2025/11/15 15:21:17

在 Redis 中，List 是一种非常常见的数据类型，用于表示一个有序的字符串集合。与传统的链表结构类似，Redis 的 List 支持在两端进行高效的插入和删除操作，因此非常适合实现队列（Queue）和栈（Stack）等数据结构。

Redis List 的基本概念

有序的字符串集合：List中的元素按插入顺序排列，每个元素都是一个字符串。
双端队列：Redis List 是一个双端队列（Deque），允许你在列表的两端高效地进行操作（插入和删除）。
最大长度：Redis 的 List 数据类型没有最大长度限制，理论上可以存储无限多的元素，除非内存不足。

List命令：

LPUSH

LPUSH 命令用于将一个或多个元素插入到列表的头部（即左侧）。如果列表不存在，Redis 会自动创建一个空列表并执行插入操作。

语法： LPUSH key value [value ...]
127.0.0.1:6379> lpush key 1 2 3 4
(integer) 4
127.0.0.1:6379> lrange key 0 -1
1) "4"
2) "3"
3) "2"
4) "1"
返回值

返回插入元素后的列表长度。

LPUSHX

LPUSHX 是一个用于将元素推入到列表（list）头部的命令，但与 LPUSH 不同的是，LPUSHX 只有在列表已存在的情况下才会执行操作。如果列表不存在，LPUSHX 不会做任何操作，也不会创建新的列表。

语法：LPUSHX key value
127.0.0.1:6379> lpush key world
(integer) 1
127.0.0.1:6379> lpushx key hello 
(integer) 2
127.0.0.1:6379> lpushx key2 hi 
(integer) 0
127.0.0.1:6379> lrange key 0 -1
1) "hello"
2) "world"
127.0.0.1:6379> lrange key2 0 -1
(empty array)
总结：

LPUSHX 用于将元素添加到已经存在的列表中，它不会创建新的列表，这与 LPUSH（无论列表是否存在都创建新列表）有所不同。

RPUSH

RPUSH 命令用于将一个或多个元素插入到列表的尾部（即右侧）。如果列表不存在，Redis 会自动创建一个空列表并执行插入操作。

语法：RPUSH key value [value ...]
127.0.0.1:6379> rpush key 1 2 3 4
(integer) 4
127.0.0.1:6379> rpush key 5 6 7 8
(integer) 8
127.0.0.1:6379> lrange key 0 -1
1) "1"
2) "2"
3) "3"
4) "4"
5) "5"
6) "6"
7) "7"
8) "8"
返回值：

返回插入元素后的列表长度。

RPUSHX 同理 LPUSHX

LRANGE

LRANGE 命令用于获取列表中的一个指定范围的元素。你可以指定开始和结束的索引位置，然后 Redis 会返回该范围内的所有元素。

语法：LRANGE key start stop
127.0.0.1:6379> lrange key 0 -1
1) "1"
2) "2"
3) "3"
4) "4"
5) "5"
6) "6"
7) "7"
8) "8"
127.0.0.1:6379> lrange key 0 3
1) "1"
2) "2"
3) "3"
4) "4"
127.0.0.1:6379> lrange key 0 100
1) "1"
2) "2"
3) "3"
4) "4"
5) "5"
6) "6"
7) "7"
8) "8"
127.0.0.1:6379> lrange key 8 10
(empty array)
127.0.0.1:6379> lrange key -8 -1
1) "1"
2) "2"
3) "3"
4) "4"
5) "5"
6) "6"
7) "7"
8) "8"
返回值：

返回指定范围内的所有元素。如果范围超出列表长度，Redis 会返回所有符合范围条件的元素。

总结：

LRANGE 用于获取 Redis 列表中指定范围的元素。
支持负数索引，可以从列表尾部获取元素。
如果 start 和 stop 超出了列表的实际长度，Redis 会自动调整范围。

LPOP

LPOP 命令用于从列表的头部（左侧）移除并返回一个元素。执行该命令时，列表的第一个元素会被移除，并返回这个被移除的元素。如果列表为空，LPOP 会返回 nil。

语法：LPOP key
127.0.0.1:6379> rpush key 1 2 3 4
(integer) 4
127.0.0.1:6379> lpop key
"1"
127.0.0.1:6379> lpop key
"2"
127.0.0.1:6379> lpop key
"3"
127.0.0.1:6379> lpop key
"4"
127.0.0.1:6379> lpop key
(nil)
返回值：

返回被移除的列表元素。
如果列表为空，返回 nil。

总结：

LPOP 是一个用于从 Redis 列表左侧移除并返回一个元素的命令。如果列表为空，返回 nil。

RPOP 同理
RPOP 命令用于从列表的尾部（右侧）移除并返回一个元素。执行该命令时，列表的最后一个元素会被移除，并返回该元素。如果列表为空，RPOP 会返回 nil。

LINDEX

LINDEX 命令用于获取列表中指定位置的元素。你可以通过指定一个索引来获取列表中对应位置的元素。

语法：LINDEX key index
127.0.0.1:6379> rpush key 1 2 3 4 5 6 7 8
(integer) 8
127.0.0.1:6379> lindex key 0
"1"
127.0.0.1:6379> lindex key 7
"8"
127.0.0.1:6379> lindex -1
127.0.0.1:6379> lindex key -1
"8"
127.0.0.1:6379> lindex key -7
"2"
127.0.0.1:6379> lindex key 9
(nil)
返回值：

返回指定位置的元素。

如果指定的索引超出了列表的范围，返回 nil。

总结：

LINDEX 用于获取 Redis 列表中指定位置的元素。可以通过正数索引或负数索引来指定位置。如果索引超出范围，返回 nil。这是一个读取操作，而不会改变列表内容

LINSERT

LINSERT 命令用于在列表中指定位置插入一个元素。你可以在列表的左侧或右侧插入元素，依据你指定的插入位置。
语法：LINSERT key BEFORE|AFTER pivot element
127.0.0.1:6379> rpush key a b c d
(integer) 4
127.0.0.1:6379> linsert key before b 111
(integer) 5
127.0.0.1:6379> linsert key after b 222
(integer) 6
27.0.0.1:6379> linsert key before e 333
(integer) -1
127.0.0.1:6379> lrange key 0 -1
1) "a"
2) "111"
3) "b"
4) "222"
5) "c"
6) "d"
返回值：

如果操作成功，返回列表的新长度。

如果 pivot 元素在列表中不存在，则不插入任何元素，返回 -1。

总结：

LINSERT 命令在 Redis 列表中指定位置插入一个新元素。可以在指定元素的前或后插入。它是一个修改列表的命令，成功执行后返回新的列表长度，如果指定的 pivot 元素不存在，则返回 -1。

LLEN

LLEN 命令用于获取列表的长度，即列表中元素的数量。

语法：LLEN key
127.0.0.1:6379> lrange key 0 -1
1) "a"
2) "111"
3) "b"
4) "222"
5) "c"
6) "d"
127.0.0.1:6379> llen key
(integer) 6
127.0.0.1:6379> llen key2
(integer) 0
返回值：

返回列表中元素的数量。如果该 key 对应的不是一个列表，或者该列表为空，返回 0。

如果 key 不存在，返回 0。

总结：

LLEN 命令用于获取 Redis 列表的长度，返回列表中元素的数量。如果列表为空或不存在，返回 0。

阻塞版本命令

blpop 和 brpop 是 lpop 和 rpop 的阻塞版本，和对应非阻塞版本的作用基本⼀致，除了：
• 在列表中有元素的情况下，阻塞和⾮阻塞表现是⼀致的。但如果列表中没有元素，非阻塞版本会理解返回 nil，但阻塞版本会根据 timeout，阻塞⼀段时间，期间 Redis 可以执行其他命令，但要求执行该命令的客户端会表现为阻塞状态（如图 2-22 ）。
• 命令中如果设置了多个键，那么会从左向右进⾏遍历键，⼀旦有一个键对应的列表中可以弹出元素，命令立即返回。
• 如果多个客户端同时多⼀个键执行 pop，则最先执行命令的客户端会得到弹出的元素。

图 2-22 阻塞版本的 blpop 和非阻塞版本 lpop 的区别

演示一下BLPOP

BLPOP 命令是 阻塞式弹出（Blocking Pop）命令，它用于从一个或多个列表中弹出一个元素。如果列表为空，命令会阻塞，直到有元素可弹出为止，或者超时。

语法：BLPOP key [key ...] timeout

此时再开一个服务器去增加key里面的元素

此时发现它在100内只有接收到key中是否有信息即可

返回值：

        如果成功弹出了元素，返回一个列表，包含两个元素：

        第一个元素是列表名称 key。

        第二个元素是从该列表中弹出的值。

        如果在 timeout 时间内没有元素可弹出，命令返回 nil。

总结：

BLPOP 是 Redis 中的阻塞式弹出命令，可以从一个或多个列表中弹出元素。它会阻塞直到列表中有元素可供弹出，或者超时。如果超时，命令返回 nil。此命令常用于任务队列或消息队列的实现。