Redis 常用命令大全:11 大类命令速查手册
Redis 是运维日常接触最多的内存数据库之一,命令数量多、参数杂,排查问题时经常需要临时翻文档。本文按数据类型和功能分类,整理 Redis 最常用的 11 大类命令,全部以速查表形式呈现,方便按需检索和收藏。
分类顺序为:连接 → key 管理 → 五大基本数据类型(String / Hash / List / Set / ZSet)→ 发布订阅 → 事务 → 脚本 → 服务器管理。命令名称统一使用大写,参数使用小写占位符。
先看一张分类速查表:
| 分类 | 代表命令 | 典型用途 |
|---|---|---|
| 连接 | AUTH、PING、SELECT |
验证密码、探活、切换库 |
| keys | DEL、EXPIRE、TTL、TYPE |
key 生命周期管理 |
| 字符串 | SET、GET、INCR |
缓存、计数器 |
| hash | HSET、HGETALL、HINCRBY |
存对象、结构化字段 |
| 列表 | LPUSH、RPOP、LRANGE |
队列、栈、时间线 |
| 集合 | SADD、SINTER、SMEMBERS |
去重、交并差集 |
| 有序集合 | ZADD、ZRANGE、ZRANK |
排行榜、延时队列 |
| 发布订阅 | SUBSCRIBE、PUBLISH |
轻量消息广播 |
| 事务 | MULTI、EXEC、WATCH |
命令打包执行 |
| 脚本 | EVAL、SCRIPT LOAD |
Lua 原子操作 |
| 服务器 | INFO、SLOWLOG、CLIENT LIST |
状态监控与故障排查 |
一、连接命令
| 命令 | 说明 |
|---|---|
AUTH password |
验证密码是否正确 |
ECHO message |
打印字符串 |
PING |
查看服务是否运行 |
QUIT |
关闭当前连接 |
SELECT index |
切换到指定的数据库 |
二、keys 命令
| 命令 | 说明 |
|---|---|
DEL key |
删除 key |
DUMP key |
序列化给定 key 并返回序列化的值 |
EXISTS key |
检查给定 key 是否存在 |
EXPIRE key seconds |
为 key 设置过期时间 |
EXPIRE key timestamp |
用时间戳的方式给 key 设置过期时间 |
PEXPIRE key milliseconds |
设置 key 的过期时间以毫秒计 |
KEYS pattern |
查找所有符合给定模式的 key |
MOVE key db |
将当前数据库的 key 移动到数据库 db 当中 |
PERSIST key |
移除 key 的过期时间,key 将持久保存 |
PTTL key |
以毫秒为单位返回 key 的剩余过期时间 |
TTL key |
以秒为单位,返回给定 key 的剩余生存时间 |
RANDOMKEY |
从当前数据库中随机返回一个 key |
RENAME key newkey |
修改 key 的名称 |
RENAMENX key newkey |
仅当 newkey 不存在时,将 key 改名为 newkey |
TYPE key |
返回 key 所存储的值的类型 |
注意:
KEYS pattern会阻塞 Redis 主线程,生产环境请使用SCAN cursor [MATCH pattern] [COUNT count]渐进式遍历。
三、字符串命令
| 命令 | 说明 |
|---|---|
SET key value |
设置 key 对应 string 类型的值 |
GET key |
获取 key 对应 string 类型的值 |
GETRANGE key start end |
返回 key 中字符串值的子字符 |
GETSET key value |
将给定 key 的值设为 value ,并返回 key 的旧值 |
GETBIT key offset |
对 key 所储存的字符串值,获取指定偏移量上的位 |
MGET key1 [key2..] |
获取一个或者多个给定 key 的值 |
SETBIT key offset value |
对 key 所储存的字符串值,设置或清除指定偏移量上的位 |
SETEX key seconds value |
将值 value 关联到 key ,并将 key 的过期时间设为 seconds (以秒为单位) |
SETNX key value |
只有在 key 不存在时设置 key 的值 |
SETRANGE key offset value |
用 value 参数覆写给定 key 所储存的字符串值,从偏移 offset 开始 |
STRLEN key |
返回 key 所储存的字符串值的长度 |
MSET key value [key value ...] |
同时设置一个或多个 key-value 对 |
MSETNX key value [key value ...] |
同时设置一个或多个 key-value 对,当且仅当所有给定 key 都不存在 |
PSETEX key milliseconds value |
这个命令和 SETEX 命令相似,但它以毫秒为单位设置 key 的生存时间,而不是像 SETEX 命令那样,以秒为单位 |
INCR key |
将 key 中储存的数字值增一 |
INCRBY key increment |
将 key 所储存的值加上给定的增量值(increment) |
INCRBYFLOAT key increment |
将 key 所储存的值加上给定的浮点增量值(increment) |
DECR key |
将 key 中储存的数字值减一 |
DECRBY key decrement |
key 所储存的值减去给定的减量值(decrement) |
APPEND key value |
如果 key 已经存在并且是一个字符串,APPEND 命令将指定 value 追加到该 key 原来值的末尾 |
四、Redis hash 命令
| 命令 | 说明 |
|---|---|
HDEL key field1 [field2] |
删除一个或多个哈希表字段 |
HEXISTS key field |
查看哈希表 key 中,指定的字段是否存在 |
HGET key field |
获取存储在哈希表中指定字段的值 |
HGETALL key |
获取在哈希表中指定 key 的所有字段和值 |
HINCRBY key field increment |
为哈希表 key 中的指定字段的整数值加上增量 increment |
HINCRBYFLOAT key field increment |
为哈希表 key 中的指定字段的浮点数值加上增量 increment |
HKEYS key |
获取所有哈希表中的字段 |
HLEN key |
获取哈希表中字段的数量 |
HMGET key field1 [field2] |
获取所有给定字段的值 |
HMSET key field1 value1 [field2 value2 ] |
同时将多个 field-value (域-值)对设置到哈希表 key 中 |
HSET key field value |
将哈希表 key 中的字段 field 的值设为 value |
HSETNX key field value |
只有在字段 field 不存在时,设置哈希表字段的值 |
HVALS key |
获取哈希表中所有值 |
HSCAN key cursor [MATCH pattern] [COUNT count] |
迭代哈希表中的键值对 |
五、Redis 列表命令
| 命令 | 说明 |
|---|---|
BLPOP key1 [key2 ] timeout |
移出并获取列表的第一个元素,如果列表没有元素会阻塞列表直到等待超时或发现可弹出元素为止 |
BRPOP key1 [key2 ] timeout |
移出并获取列表的最后一个元素,如果列表没有元素会阻塞列表直到等待超时或发现可弹出元素为止 |
BRPOPLPUSH source destination timeout |
从列表中弹出一个值,将弹出的元素插入到另外一个列表中并返回它;如果列表没有元素会阻塞列表直到等待超时或发现可弹出元素 |
LINDEX key index |
通过索引获取列表中的元素 |
| `LINSERT key BEFORE | AFTER pivot value` |
LLEN key |
获取列表长度 |
LPOP key |
移出并获取列表的第一个元素 |
LPUSH key value1 [value2] |
将一个或多个值插入到列表头部 |
LPUSHX key value |
将一个值插入到已存在的列表头部 |
LRANGE key start stop |
获取列表指定范围内的元素 |
LREM key count value |
移除列表元素 |
LSET key index value |
通过索引设置列表元素的值 |
LTRIM key start stop |
对一个列表进行修剪(trim),就是说,让列表只保留指定区间内的元素,不在指定区间之内的元素都将被删除 |
RPOP key |
移出并获取列表的最后一个元素 |
RPOPLPUSH source destination |
移除列表的最后一个元素,并将该元素添加到另一个列表并返回 |
RPUSH key value1 [value2] |
在列表中添加一个或多个值 |
RPUSHX key value |
为已存在的列表添加值 |
六、Redis 集合命令
| 命令 | 说明 |
|---|---|
SADD key member1 [member2] |
向集合添加一个或多个成员 |
SCARD key |
获取集合的成员数 |
SDIFF key1 [key2] |
返回给定所有集合的差集 |
SDIFFSTORE destination key1 [key2] |
返回给定所有集合的差集并存储在 destination 中 |
SINTER key1 [key2] |
返回给定所有集合的交集 |
SINTERSTORE destination key1 [key2] |
返回给定所有集合的交集并存储在 destination 中 |
SISMEMBER key member |
判断 member 元素是否是集合 key 的成员 |
SMEMBERS key |
返回集合中的所有成员 |
SMOVE source destination member |
将 member 元素从 source 集合移动到 destination 集合 |
SPOP key |
移除并返回集合中的一个随机元素 |
SRANDMEMBER key [count] |
返回集合中一个或多个随机数 |
SREM key member1 [member2] |
移除集合中一个或多个成员 |
SUNION key1 [key2] |
返回所有给定集合的并集 |
SUNIONSTORE destination key1 [key2] |
所有给定集合的并集存储在 destination 集合中 |
SSCAN key cursor [MATCH pattern] [COUNT count] |
迭代集合中的元素 |
七、Redis 有序集合命令
| 命令 | 说明 |
|---|---|
ZADD key score1 member1 [score2 member2] |
向有序集合添加一个或多个成员,或者更新已存在成员的分数 |
ZCARD key |
获取有序集合的成员数 |
ZCOUNT key min max |
计算在有序集合中指定区间分数的成员数 |
ZINCRBY key increment member |
有序集合中对指定成员的分数加上增量 increment |
ZINTERSTORE destination numkeys key [key ...] |
计算给定的一个或多个有序集的交集并将结果集存储在新的有序集合 key 中 |
ZLEXCOUNT key min max |
在有序集合中计算指定字典区间内成员数量 |
ZRANGE key start stop [WITHSCORES] |
通过索引区间返回有序集合成指定区间内的成员 |
ZRANGEBYLEX key min max [LIMIT offset count] |
通过字典区间返回有序集合的成员 |
ZRANGEBYSCORE key min max [WITHSCORES] [LIMIT] |
通过分数返回有序集合指定区间内的成员 |
ZRANK key member |
返回有序集合中指定成员的索引 |
ZREM key member [member ...] |
移除有序集合中的一个或多个成员 |
ZREMRANGEBYLEX key min max |
移除有序集合中给定的字典区间的所有成员 |
ZREMRANGEBYRANK key start stop |
移除有序集合中给定的排名区间的所有成员 |
ZREMRANGEBYSCORE key min max |
移除有序集合中给定的分数区间的所有成员 |
ZREVRANGE key start stop [WITHSCORES] |
返回有序集中指定区间内的成员,分数从高到低 |
ZREVRANGEBYSCORE key max min [WITHSCORES] |
返回有序集中指定分数区间内的成员,分数从高到低排序 |
ZREVRANK key member |
返回有序集合中指定成员的排名,有序集成员按分数值递减(从大到小)排序 |
ZSCORE key member |
返回有序集中,成员的分数值 |
ZUNIONSTORE destination numkeys key [key ...] |
计算给定的一个或多个有序集的并集,并存储在新的 key 中 |
ZSCAN key cursor [MATCH pattern] [COUNT count] |
迭代有序集合中的元素(包括元素成员和元素分值) |
八、Redis 发布订阅命令
| 命令 | 说明 |
|---|---|
PSUBSCRIBE pattern [pattern ...] |
订阅一个或多个符合给定模式的频道 |
PUBSUB subcommand [argument [argument ...]] |
查看订阅与发布系统状态 |
PUBLISH channel message |
将信息发送到指定的频道 |
PUNSUBSCRIBE [pattern [pattern ...]] |
退订所有给定模式的频道 |
SUBSCRIBE channel [channel ...] |
订阅给定的一个或多个频道的信息 |
UNSUBSCRIBE [channel [channel ...]] |
指退订给定的频道 |
示例:
bash
redis 127.0.0.1:6379> SUBSCRIBE redisChat
Reading messages... (press Ctrl-C to quit)
1) "subscribe"
2) "redisChat"
3) (integer) 1
现在,我们先重新开启个 redis 客户端,然后在同一个频道 redisChat 发布两次消息,订阅者就能接收到消息:
bash
redis 127.0.0.1:6379> PUBLISH redisChat "Redis is a great caching technique"
(integer) 1
订阅者的客户端会显示如下消息:
bash
1) "message"
2) "redisChat"
3) "Redis is a great caching technique"
九、Redis 事务命令
| 命令 | 说明 |
|---|---|
DISCARD |
取消事务,放弃执行事务块内的所有命令 |
EXEC |
执行所有事务块内的命令 |
MULTI |
标记一个事务块的开始 |
UNWATCH |
取消 WATCH 命令对所有 key 的监视 |
WATCH key [key ...] |
监视一个(或多个) key ,如果在事务执行之前这个(或这些) key 被其他命令所改动,那么事务将被打断 |
十、Redis 脚本命令
| 命令 | 说明 |
|---|---|
EVAL script numkeys key [key ...] arg [arg ...] |
执行 Lua 脚本 |
EVALSHA sha1 numkeys key [key ...] arg [arg ...] |
执行 Lua 脚本(缓存) |
SCRIPT EXISTS script [script ...] |
查看指定的脚本是否已经被保存在缓存当中 |
SCRIPT FLUSH |
从脚本缓存中移除所有脚本 |
SCRIPT KILL |
杀死当前正在运行的 Lua 脚本 |
SCRIPT LOAD script |
将脚本 script 添加到脚本缓存中,但并不立即执行这个脚本 |
十一、Redis 服务器命令
| 命令 | 说明 |
|---|---|
BGREWRITEAOF |
异步执行一个 AOF(AppendOnly File)文件重写操作 |
BGSAVE |
在后台异步保存当前数据库的数据到磁盘 |
CLIENT KILL [ip:port] [ID client-id] |
关闭客户端连接 |
CLIENT LIST |
获取连接到服务器的客户端连接列表 |
CLIENT GETNAME |
获取连接的名称 |
CLIENT PAUSE timeout |
在指定时间内终止运行来自客户端的命令 |
CLIENT SETNAME connection-name |
设置当前连接的名称 |
CLUSTER SLOTS |
获取集群节点的映射数组 |
COMMAND |
获取 Redis 命令详情数组 |
COMMAND COUNT |
获取 Redis 命令总数 |
COMMAND GETKEYS |
获取给定命令的所有键 |
TIME |
返回当前服务器时间 |
COMMAND INFO command-name [command-name ...] |
获取指定 Redis 命令描述的数组 |
CONFIG GET parameter |
获取指定配置参数的值 |
CONFIG REWRITE |
对启动 Redis 服务器时所指定的 redis.conf 配置文件进行改写 |
CONFIG SET parameter value |
修改 redis 配置参数,无需重启 |
CONFIG RESETSTAT |
重置 INFO 命令中的某些统计数据 |
DBSIZE |
返回当前数据库的 key 的数量 |
DEBUG OBJECT key |
获取 key 的调试信息 |
DEBUG SEGFAULT |
让 Redis 服务崩溃 |
FLUSHALL |
删除所有数据库的所有 key |
FLUSHDB |
删除当前数据库的所有 key |
INFO [section] |
获取 Redis 服务器的各种信息和统计数值 |
LASTSAVE |
返回最近一次 Redis 成功将数据保存到磁盘上的时间,以 UNIX 时间戳格式表示 |
MONITOR |
实时打印出 Redis 服务器接收到的命令,调试用 |
ROLE |
返回主从实例所属的角色 |
SAVE |
同步保存数据到硬盘 |
SHUTDOWN [NOSAVE] [SAVE] |
异步保存数据到硬盘,并关闭服务器 |
SLAVEOF host port |
将当前服务器转变为指定服务器的从属服务器(slave server) |
SLOWLOG subcommand [argument] |
管理 redis 的慢日志 |
SYNC |
用于复制功能(replication)的内部命令 |
总结
Redis 命令虽然多,但日常真正高频的其实集中在几处:
- 数据结构选型:简单缓存用 String,对象用 Hash,队列用 List,去重和标签用 Set,排行榜和延时任务用 ZSet
- key 管理 :线上排查优先用
SCAN替代KEYS,用TTL/PTTL确认过期策略是否生效 - 故障排查 :
INFO看内存与连接数,SLOWLOG GET找慢命令,CLIENT LIST定位异常连接,MONITOR用于短时间抓取实时命令流(有性能开销,用完立即退出)
把这几组命令用熟,绝大多数 Redis 相关的线上问题都能快速定位。