列表（List）相当于数组或者顺序表

一、通用命令

1. LPUSH key value1 [value2 ...]

   • 在列表 key 的左侧（头部）插入一个或多个值。
   • 示例：LPUSH fruits apple banana → 列表变为 [banana, apple]

• LPUSHX 只有列表已存在时才会执行插入，若列表不存在则不进行任何操作

1. RPUSH key value1 [value2 ...]

   • 在列表 key 的右侧（尾部）插入一个或多个值。
   • 示例：RPUSH fruits orange → 列表变为 [banana, apple, orange]

RPUSHX 只有列表已存在时才会执行插入，若列表不存在则不进行任何操作

1. LPOP key

   • 移除并返回列表 key 左侧的第一个元素。
   • 示例：LPOP fruits → 返回 banana，列表变为 [apple, orange]

lpop后面有个count参数，表示要删删除几个元素

1. RPOP key

   • 移除并返回列表 key 右侧的最后一个元素。
   • 示例：RPOP fruits → 返回 orange，列表变为 [apple]

rpop后面有个count参数，表示要删删除几个元素

1. LRANGE key start stop

   • 返回列表 key 中从索引 start 到 stop 的元素（包含两端）。
   • 索引支持负数：-1 表示最后一个元素，-2 表示倒数第二个，以此类推。
   • 示例：LRANGE fruits 0 -1 → 返回列表所有元素

当下标越界后，会尽可能的返回结果，返回区间内存在的元素

1. LLEN key

   • 返回列表 key 的长度（元素个数）。
   • 示例：LLEN fruits → 返回当前列表长度

1. LINDEX key index

   • 返回列表 key 中索引为 index 的元素。
   • 示例：LINDEX fruits 0 → 返回列表第一个元素

1.LINSERT 是用于在列表的指定元素前后插入新元素的命令，其语法如下：

LINSERT key BEFORE|AFTER pivot value

参数说明：

• key：列表的键名
• BEFORE|AFTER：指定插入位置（在 pivot 元素之前或之后）
• pivot：列表中已存在的参考元素
• value：要插入的新元素

1. LSET key index value

   • 将列表 key 中索引为 index 的元素设置为 value。
   • 示例：LSET fruits 0 grape → 将第一个元素改为 grape

2. LREM key count value

   • 从列表 key 中删除 count 个值为 value 的元素。
   • count > 0：从左侧开始删除；count < 0：从右侧开始删除；count = 0：删除所有。
   • 示例：LREM fruits 2 apple → 从左侧删除 2 个 apple

3. LTRIM key start stop

   • 保留列表 key 中从 start 到 stop 的元素，删除其他元素（修剪列表）。
   • 示例：LTRIM fruits 0 1 → 只保留前两个元素

4. RPOPLPUSH source destination

   • 从 source 列表右侧弹出元素，同时将其插入 destination 列表左侧。
   • 示例：RPOPLPUSH fruits backups → 转移最后一个元素到 backups 列表头部

  5、BLPOP和BRPOP

在 Redis 中，BLPOP 和 BRPOP 是 阻塞式列表弹出命令，核心作用是从列表（List）的头部或尾部弹出元素；若列表为空，则命令会阻塞当前客户端，直到有元素可用或超时，常用于实现 消息队列、任务调度、分布式锁等待 等场景。

一、核心定义与语法

两者逻辑一致，仅弹出元素的位置不同：

• BLPOP（Block Left Pop）：从列表 头部（左侧） 弹出元素，空列表时阻塞。
• BRPOP（Block Right Pop）：从列表 尾部（右侧） 弹出元素，空列表时阻塞。

1. 基本语法

BLPOP key [key ...] timeout
BRPOP key [key ...] timeout

参数说明：

2. 返回值

命令返回一个 二元数组，格式如下：

二、核心特性与差异

1. 共性：阻塞逻辑与优先级

无论 BLPOP 还是 BRPOP，阻塞时均遵循以下规则：

• 空列表阻塞：若所有监听的列表均为空，客户端会进入 阻塞状态（不占用 CPU，Redis 会将其加入 “阻塞客户端队列”），不影响其他命令执行。
• 元素触发唤醒：当其他客户端向任一监听列表添加元素（如 LPUSH/RPUSH）时，Redis 会立即唤醒阻塞的客户端，执行弹出操作。
• 多键优先级：若同时监听多个列表（如 BLPOP list1 list2 0），Redis 会 按键的顺序依次检查，仅从第一个非空列表中弹出元素（list1 优先级高于 list2）。
• 单元素原子性：即使多个客户端同时阻塞监听同一个列表，Redis 会保证 每个元素仅被一个客户端弹出（原子操作，无 “竞态问题”）。

2. 差异：弹出位置与典型场景

三、使用示例

假设存在两个列表 task_queue（任务队列）和 urgent_queue（紧急任务队列），用 BLPOP 优先处理紧急任务：

1. 列表为空时阻塞

执行命令（超时时间 30 秒）：

BLPOP urgent_queue task_queue 30

此时两个列表均为空，客户端进入 阻塞状态，等待元素插入。

2. 其他客户端插入元素

另一个客户端向 urgent_queue 插入紧急任务：

RPUSH urgent_queue "fix_login_bug"

3. 阻塞客户端被唤醒并返回结果

原阻塞客户端立即被唤醒，返回以下结果（二元数组）：

1) "urgent_queue"  # 元素所属的键
2) "fix_login_bug" # 弹出的元素值

4. 超时无元素返回

若 30 秒内无任何客户端向 urgent_queue 或 task_queue 插入元素，命令超时返回 nil：

(nil)

四、关键注意事项

1. 阻塞仅影响当前客户端
   阻塞期间，当前客户端无法执行其他命令，但 Redis 服务器仍可正常处理其他客户端的请求（非全局阻塞）。

2. 避免永久阻塞（timeout=0）的风险
   若设置 timeout=0（永久阻塞），需确保有其他客户端会向监听列表插入元素；否则当前客户端会一直阻塞，需通过 CLIENT KILL 命令强制关闭连接。

3. 键不存在的处理
   若监听的键不存在（如 BLPOP non_exist_key 5），Redis 会将其视为 “空列表”，同样触发阻塞，直到键被创建并插入元素。

4. 与非阻塞命令的区别（LPOP/RPOP）

   • LPOP/RPOP：列表为空时立即返回 nil，不阻塞；
   • BLPOP/BRPOP：列表为空时阻塞，适合需要 “等待元素” 的场景（如消息队列消费者）。

5. 分布式场景的限制
   若多个客户端同时阻塞监听同一个列表，Redis 会按 “先阻塞先唤醒” 的顺序分配元素（公平性保证），但不支持 “广播”（一个元素仅被一个客户端消费）。

五、典型应用场景

1. 消息队列（MQ）

   • 生产者：用 RPUSH 向列表尾部插入消息；
   • 消费者：用 BRPOP 阻塞监听列表，有消息时立即消费（避免轮询空列表，减少资源浪费）。

2. 分布式任务调度
   多个 worker 进程用 BLPOP 监听同一个任务列表，Redis 自动将任务分配给空闲 worker（原子性弹出，避免重复处理）。

3. 分布式锁的 “等待重试”
   当客户端获取锁失败时，用 BLPOP 阻塞监听 “锁释放通知列表”，待持有锁的客户端释放锁后，通过 LPUSH 通知等待客户端重试，减少轮询开销。