Redis List 数据类型详解与 Java 实战

Redis List 是存储有序字符串的容器，底层采用双向链表实现，支持 O(1) 复杂度的两端操作。详细讲解了 LPUSH、RPUSH、LRANGE 等核心命令，并提供了基于 Spring Boot StringRedisTemplate 的 Java 封装示例，涵盖列表增删改查及商品评论场景的实际应用。

岁月神偷发布于 2026/3/21更新于 2026/4/183 浏览

Redis List 数据类型

概述

存储内容 可存储有序的字符串列表。
常用操作 向列表两端添加元素、获取列表的某一个片段。
底层实现 基于双向链表（double linked list）。
性能特性
- 向列表两端添加元素的时间复杂度为 O(1)；
- 获取元素时，越接近列表两端的元素，访问速度越快；
- 极端场景验证：即便列表包含几千万个元素，获取其头部或尾部的 10 条记录仍能达到极快的速度。

命令

向列表两端增加元素

执行 lpush/rpush 时，Redis 会自动创建这个列表，并将元素插入。如果列表存在就会在已有列表上进行操作。

左侧（头部）增加：多个值按传入顺序依次从左侧插入。
```
lpush key value [value ...]
```
右侧（尾部）增加：多个值按传入顺序依次从右侧插入。
```
rpush key value [value ...]
```

从列表两端弹出元素

lpop key
rpop key

lpop 命令从列表左边弹出一个元素，会分两步完成。第一步是将列表左边的元素从列表中移除，第二步是返回被移除的元素值。rpop 同理。

获取列表中元素个数

llen key

获取列表片段

lrange key start stop

lrange 命令是列表类型最常用的命令之一，获取列表中的某一片段，将返回 start、stop 之间的所有元素（包含两端的元素），索引从 0 开始。索引可以是负数，如："-1"代表最后边的一个元素。

删除列表中指定的值

lrem key count value

lrem 命令会在列表里找值为 value 的元素，然后只删除其中的前 count 个。根据 count 值的不同，该命令的执行方式会有所不同：

当 count > 0 时，LREM 会从列表左边开始删除。
当 count < 0 时，LREM 会从列表后边开始删除。
当 count = 0 时，LREM 删除所有值为 value 的元素。

获取/设置指定索引的元素值

LINDEX key index
LSET key index value

只保留列表指定片段

只保留列表指定片段，指定范围和 LRANGE 一致。

LTRIM key start stop

向列表中插入元素

LINSERT key BEFORE|AFTER pivot value

该命令首先会在列表中从左到右查找值为 pivot 的元素，然后根据第二个参数是 BEFORE 还是 AFTER 来决定将 value 插入到该元素的前面还是后面。

将元素从一个列表转移到另一个列表中

相关免费在线工具

Keycode 信息

查找任何按下的键的javascript键代码、代码、位置和修饰符。在线工具，Keycode 信息在线工具，online

Escape 与 Native 编解码

JavaScript 字符串转义/反转义；Java 风格 \uXXXX（Native2Ascii）编码与解码。在线工具，Escape 与 Native 编解码在线工具，online

JavaScript / HTML 格式化

使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。在线工具，JavaScript / HTML 格式化在线工具，online

JavaScript 压缩与混淆

Terser 压缩、变量名混淆，或 javascript-obfuscator 高强度混淆（体积会增大）。在线工具，JavaScript 压缩与混淆在线工具，online

Base64 字符串编码/解码

将字符串编码和解码为其 Base64 格式表示形式即可。在线工具，Base64 字符串编码/解码在线工具，online

Base64 文件转换器

将字符串、文件或图像转换为其 Base64 表示形式。在线工具，Base64 文件转换器在线工具，online

功能	StringRedisTemplate 方法	对应 Redis 命令	代码中的作用
右侧（尾部）添加元素	opsForList().rightPush(key, value)	rpush	向列表尾部追加单个元素
左侧（头部）添加元素	opsForList().leftPush(key, value)	lpush	向列表头部插入单个元素（最新元素在头部，适合评论/消息场景）
获取指定范围元素	opsForList().range(key, start, end)	lrange	获取列表中 start 到 end 下标元素（0,-1 表示所有元素，0,3 表示前 4 个）
获取列表长度	opsForList().size(key)	llen	返回列表的元素总个数
修改指定下标值	opsForList().set(key, index, value)	lset	更新列表中指定下标位置的元素值
获取指定下标值	opsForList().index(key, index)	lindex	查询列表中指定下标位置的元素值
删除指定数量的目标值	opsForList().remove(key, count, value)	lrem	按方向删除 count 个值为 value 的元素（count>0 从左删，count=0 删所有）
截取列表保留指定区间	opsForList().trim(key, start, end)	ltrim	仅保留列表中 start 到 end 下标元素，删除区间外所有元素
左侧（头部）出栈	opsForList().leftPop(key)	lpop	从列表头部弹出元素（元素从列表中移除，返回弹出值）

功能	StringRedisTemplate 方法	对应 Redis 命令	代码中的作用
删除整个列表	delete(key)	del	直接删除列表键，清空列表所有元素
清空当前数据库	getConnectionFactory().getConnection().flushDb()	flushdb	清空当前 Redis 库的所有键（含 List、Hash、String 等所有类型）

package com.qcby.springbootredis; import org.junit.jupiter.api.Test; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.boot.test.context.SpringBootTest; import org.springframework.data.redis.core.StringRedisTemplate; import java.util.List; @SpringBootTest public class ListTest { @Autowired private StringRedisTemplate stringRedisTemplate; /** * List 类型核心操作 */ @Test public void testList() { System.out.println("==List=="); try { // 1. 移除指定 list 的所有内容 stringRedisTemplate.delete("messages"); // 2. 向 list 右侧（尾部）添加元素 stringRedisTemplate.opsForList().rightPush("messages", "Hello how are you?"); stringRedisTemplate.opsForList().rightPush("messages", "Fine thanks. I'm having fun with redis."); stringRedisTemplate.opsForList().rightPush("messages", "I should look into this NOSQL thing ASAP"); // 3. 获取 list 所有元素 (0 = 起始下标，-1 = 结束下标) List<String> values = stringRedisTemplate.opsForList().range("messages", 0, -1); System.out.println("messages 所有元素：" + values); // 4. 清空当前数据库 stringRedisTemplate.getConnectionFactory().getConnection().flushDb(); System.out.println("清空当前数据库成功"); // 5. 向 list 左侧（头部）添加元素 stringRedisTemplate.opsForList().leftPush("lists", "vector"); stringRedisTemplate.opsForList().leftPush("lists", "ArrayList"); stringRedisTemplate.opsForList().leftPush("lists", "LinkedList"); // 6. 获取 list 长度 Long listSize = stringRedisTemplate.opsForList().size("lists"); System.out.println("lists 长度：" + listSize); // 7. 获取 list 指定范围元素 List<String> rangeValues = stringRedisTemplate.opsForList().range("lists", 0, 2); System.out.println("lists 0-2 范围元素：" + rangeValues); // 8. 修改 list 指定下标的值 stringRedisTemplate.opsForList().set("lists", 0, "hello list!"); System.out.println("修改 lists 下标 0 的值为 hello list! 成功"); // 9. 获取 list 指定下标的值 String indexValue = stringRedisTemplate.opsForList().index("lists", 1); System.out.println("lists 下标 1 的值：" + indexValue); // 10. 删除 list 中指定数量的目标值 Long removeCount = stringRedisTemplate.opsForList().remove("lists", 1, "vector"); System.out.println("删除 lists 中 vector 的数量：" + removeCount); // 11. 截取 list 保留指定区间 stringRedisTemplate.opsForList().trim("lists", 0, 1); System.out.println("截取 lists 0-1 区间，删除其他元素成功"); // 12. list 左侧（头部）出栈 String leftPopValue = stringRedisTemplate.opsForList().leftPop("lists"); System.out.println("lists 左侧出栈元素：" + leftPopValue); // 13. 再次获取 list 所有元素 List<String> finalValues = stringRedisTemplate.opsForList().range("lists", 0, -1); System.out.println("lists 最终剩余元素：" + finalValues); } catch (Exception e) { e.printStackTrace(); } } /** * 商品评论列表业务场景实现 */ @Test public void testGoodsCommentList() { // 1. 定义商品评论列表 key String goodsCommentKey = "items:comment:1001"; // 2. 模拟用户发布商品评论（JSON 字符串，左侧插入 List → 最新评论在头部） String comment1 = "{\"id\":1,\"name\":\"商品不错，很好！！\",\"date\":1430295077289}"; String comment2 = "{\"id\":2,\"name\":\"质量很好，性价比高\",\"date\":1430295177289}"; stringRedisTemplate.opsForList().leftPush(goodsCommentKey, comment1); stringRedisTemplate.opsForList().leftPush(goodsCommentKey, comment2); // 3. 模拟页面查询评论列表 List<String> goodsComments = stringRedisTemplate.opsForList().range(goodsCommentKey, 0, -1); // 4. 打印展示评论列表 System.out.println("商品 1001 评论列表："); for (String comment : goodsComments) { System.out.println(comment); } } }

Redis List 数据类型详解与 Java 实战

Redis List 数据类型

概述

命令

向列表两端增加元素

从列表两端弹出元素

获取列表中元素个数

获取列表片段

删除列表中指定的值

获取/设置指定索引的元素值

只保留列表指定片段

向列表中插入元素

将元素从一个列表转移到另一个列表中

更多推荐文章

相关免费在线工具

Java 实现

List 类型核心操作

List 关联的通用操作

结论

代码示例

Redis List 数据类型详解与 Java 实战

Redis List 数据类型

概述

命令

向列表两端增加元素

从列表两端弹出元素

获取列表中元素个数

获取列表片段

删除列表中指定的值

获取/设置指定索引的元素值

只保留列表指定片段

向列表中插入元素

将元素从一个列表转移到另一个列表中

微信扫一扫，关注极客日志

更多推荐文章

相关免费在线工具

Java 实现

List 类型核心操作

List 关联的通用操作

结论

代码示例