【Redis】 Redis 列表指令指南

---

这是我父亲 日记里的文字
这是他的生命 留下留下来的散文诗
几十年后 我看着泪流不止
可我的父亲已经 老得像一个影子
                     🎵 许飞《父亲写的散文诗》

---

Redis 是一个开源的内存数据库，支持多种数据结构，其中列表（List）是一种常用的数据类型。Redis 列表是一个简单的链表，允许在头部和尾部进行快速的插入和删除操作，非常适合消息队列等应用场景。本文将详细介绍 Redis 列表的常用指令及其使用方法。

一、基本操作

1. 左/右插入和弹出
   LPUSH
   LPUSH 命令用于将一个或多个值插入到列表头部。如果列表不存在，将创建一个空列表并执行插入操作。

LPUSH key value [value ...]

示例：

LPUSH mylist "world"
LPUSH mylist "hello"
# mylist 现在包含 ["hello", "world"]

RPUSH
RPUSH 命令用于将一个或多个值插入到列表尾部。如果列表不存在，将创建一个空列表并执行插入操作。

RPUSH key value [value ...]

示例：

RPUSH mylist "hello"
RPUSH mylist "world"
# mylist 现在包含 ["hello", "world"]

LPOP
LPOP 命令用于移除并返回列表头部的元素。

LPOP key

示例：

LPOP mylist
# 返回 "hello"
# mylist 现在包含 ["world"]

RPOP
RPOP 命令用于移除并返回列表尾部的元素。

RPOP key

示例：

RPOP mylist
# 返回 "world"
# mylist 现在包含 ["hello"]

二、获取列表元素

1. 获取指定范围内的元素

LRANGE
LRANGE 命令用于获取列表中指定范围内的元素。索引从0开始，可以使用负数表示从列表尾部开始的偏移量。

LRANGE key start stop

示例：

RPUSH mylist "one"
RPUSH mylist "two"
RPUSH mylist "three"
LRANGE mylist 0 1
# 返回 ["one", "two"]
LRANGE mylist 0 -1
# 返回 ["one", "two", "three"]

2. 获取列表长度

LLEN
LLEN 命令用于获取列表的长度。

LLEN key

示例：

LLEN mylist
# 返回 3

3. 获取指定索引的元素

LINDEX
LINDEX 命令用于通过索引获取列表中的元素。索引从0开始，可以使用负数表示从列表尾部开始的偏移量。

LINDEX key index

示例：

LINDEX mylist 1
# 返回 "two"

4. 设置指定索引的元素

LSET
LSET 命令用于设置列表中指定索引的元素。如果索引超出范围，将返回错误。

LSET key index value

示例：

LSET mylist 1 "new"
LINDEX mylist 1
# 返回 "new"

三、删除列表元素

1. 删除指定值的元素

LREM
LREM 命令用于从列表中删除指定值的元素。可以指定删除的数量，正数表示从头到尾删除，负数表示从尾到头删除，0 表示删除所有匹配的元素。

LREM key count value

示例：

RPUSH mylist "hello"
RPUSH mylist "hello"
RPUSH mylist "world"
LREM mylist -2 "hello"
# mylist 现在包含 ["world"]

2. 截取列表

LTRIM
LTRIM 命令用于对列表进行修剪，只保留指定范围内的元素。

LTRIM key start stop

示例：

RPUSH mylist "one"
RPUSH mylist "two"
RPUSH mylist "three"
LTRIM mylist 1 -1
# mylist 现在包含 ["two", "three"]

四、阻塞操作

1. 阻塞弹出元素

BLPOP
BLPOP 命令用于阻塞地移除并返回列表的第一个元素。如果列表为空，则阻塞等待直到有新的元素插入或超时。

BLPOP key [key ...] timeout

示例：

BLPOP mylist 5
# 如果 mylist 为空，阻塞最多 5 秒

BRPOP
BRPOP 命令用于阻塞地移除并返回列表的最后一个元素。如果列表为空，则阻塞等待直到有新的元素插入或超时。

BRPOP key [key ...] timeout

示例：

BRPOP mylist 5
# 如果 mylist 为空，阻塞最多 5 秒

五、插入和替换操作

1. 在指定元素前后插入新元素

LINSERT
LINSERT 命令用于在列表的指定值前或后插入新元素。如果指定值不存在，将不进行任何操作。

LINSERT key BEFORE|AFTER pivot value

示例：

RPUSH mylist "hello"
RPUSH mylist "world"
LINSERT mylist BEFORE "world" "there"
# mylist 现在包含 ["hello", "there", "world"]

结论

Redis 列表提供了丰富的指令，可以实现从简单的插入、删除到复杂的阻塞操作等多种功能。通过掌握这些指令，您可以充分利用 Redis 列表来处理各种应用场景，如消息队列、任务调度、日志存储等。希望这篇指南能帮助您更好地理解和使用 Redis 列表指令，如果有任何问题或需要进一步的帮助，欢迎随时提问。