Redis 作为高性能的键值存储数据库,提供了丰富的命令集,主要涵盖 字符串 (String)、哈希 (Hash)、列表 (List)、集合 (Set)、有序集合 (ZSet)、键 (Keys)、Geo(地理位置)、HyperLogLog(基数统计)、Bitmap(位图)、BitField(位操作)、Scan(迭代查询) 操作。
下面按照类别分类总结 Redis 的常用命令及其使用方式。
基本操作
1. Key(键)操作
命令 | 作用 |
---|---|
EXISTS key |
检查 key 是否存在 |
DEL key [key ...] |
删除一个或多个 key |
EXPIRE key seconds |
设置 key 的过期时间 |
TTL key |
查看 key 剩余的生存时间 |
RENAME key newkey |
修改 key 的名称 |
TYPE key |
获取 key 对应的 value 类型 |
KEYS pattern |
查找符合 pattern 规则的 key |
示例
SET name "redis"
EXPIRE name 10
TTL name
DEL name
2. 字符串 (String)
命令 | 说明 |
---|---|
SET key value | 设置指定 key 的值 |
GET key | 获取指定 key 的值 |
GETSET key value | 设置新值并返回旧值 |
MGET key [key ...] | 同时获取多个 key 的值 |
MSET key value [key value ...] | 同时设置多个 key 的值 |
MSETNX key value [key value ...] | 同时设置多个 key 的值(当所有 key 都不存在时才执行) |
SETNX key value | 当 key 不存在时,设置 key 的值 |
SETEX key seconds value | 设置 key 的值,并指定过期时间(秒) |
PSETEX key milliseconds value | 设置 key 的值,并指定过期时间(毫秒) |
STRLEN key | 返回 key 中字符串值的长度 |
APPEND key value | 追加 value 到 key 原有值的末尾 |
GETRANGE key start end | 获取字符串指定区间内的子字符串(旧别名:SUBSTR) |
SETRANGE key offset value | 从指定偏移量开始,覆盖写入字符串 |
INCR key | 将 key 中存储的数字加 1 |
INCRBY key increment | 将 key 中存储的数字加上指定增量 |
INCRBYFLOAT key increment | 将 key 中存储的浮点数加上指定增量 |
DECR key | 将 key 中存储的数字减 1 |
DECRBY key decrement | 将 key 中存储的数字减去指定减量 |
GETBIT key offset | 返回字符串中指定偏移量处的位值 |
SETBIT key offset value | 将字符串中指定偏移量处的位设置为 0 或 1 |
BITCOUNT key [start end] | 统计字符串中值为 1 的位数 |
BITOP operation destkey key [key ...] | 对一个或多个 key 进行位操作(AND、OR、XOR、NOT) |
BITPOS key bit [start] [end] | 查找字符串中第一个指定二进制位的位置 |
示例
SET username "Tom"
GET username
INCR count
DECR count
APPEND username " Smith"
STRLEN username
3. 哈希 (Hash)
命令 | 说明 |
---|---|
HSET key field value | 为哈希表中的字段赋值 |
HSETNX key field value | 仅当字段不存在时,为哈希表中的字段赋值 |
HMSET key field value [field value ...] | 同时为多个字段赋值(新版 Redis 建议使用 HSET 多参数形式) |
HGET key field | 获取哈希表中指定字段的值 |
HMGET key field [field ...] | 获取哈希表中多个字段的值 |
HDEL key field [field ...] | 删除哈希表中一个或多个字段 |
HEXISTS key field | 检查哈希表中是否存在指定字段 |
HLEN key | 返回哈希表中字段的数量 |
HKEYS key | 返回哈希表中所有的字段名称 |
HVALS key | 返回哈希表中所有字段对应的值 |
HGETALL key | 返回哈希表中所有的字段和值 |
HINCRBY key field increment | 将哈希表中指定字段的整数值增加指定数值 |
HINCRBYFLOAT key field increment | 将哈希表中指定字段的浮点数值增加指定数值 |
HSTRLEN key field | 返回哈希表中指定字段对应的值的字符串长度 |
示例
HSET user:1001 name "Alice"
HGET user:1001 name
HGETALL user:1001
HDEL user:1001 name
4. 列表 (List)
命令 | 说明 |
---|---|
LPUSH key value [value ...] | 将一个或多个值插入到列表的头部 |
RPUSH key value [value ...] | 将一个或多个值插入到列表的尾部 |
LPOP key | 移除并返回列表的第一个元素 |
RPOP key | 移除并返回列表的最后一个元素 |
LINDEX key index | 通过索引获取列表中的元素(索引从 0 开始,负数表示从尾部开始) |
LLEN key | 获取列表的长度 |
LRANGE key start stop | 获取列表中指定区间内的元素 |
**LINSERT key BEFORE | AFTER pivot value** |
LSET key index value | 对列表中指定索引位置的元素进行赋值 |
LREM key count value | 根据参数 count 的值,移除列表中与 value 相等的元素 |
LTRIM key start stop | 对列表进行修剪,只保留指定区间内的元素 |
RPOPLPUSH source destination | 移除 source 列表的最后一个元素,并将其添加到 destination 列表的头部,同时返回该元素 |
BLPOP key [key ...] timeout | 阻塞式地移除并返回列表的第一个元素(可同时阻塞多个列表) |
BRPOP key [key ...] timeout | 阻塞式地移除并返回列表的最后一个元素 |
BRPOPLPUSH source destination timeout | 阻塞式地执行 RPOPLPUSH 操作 |
LPUSHX key value | 当列表存在时,将值插入到列表头部 |
RPUSHX key value | 当列表存在时,将值插入到列表尾部 |
示例
LPUSH queue "task1"
RPUSH queue "task2"
LPOP queue
LRANGE queue 0 -1
5. 集合 (Set)
命令 | 说明 |
---|---|
SADD key member [member ...] | 向集合中添加一个或多个成员 |
SREM key member [member ...] | 移除集合中的一个或多个成员 |
SMEMBERS key | 返回集合中的所有成员 |
SISMEMBER key member | 判断指定元素是否集合的成员 |
SCARD key | 获取集合中成员的数量 |
SINTER key [key ...] | 返回给定所有集合的交集 |
SINTERSTORE destination key [key ...] | 计算给定集合的交集,并将结果存储在 destination 中 |
SUNION key [key ...] | 返回给定所有集合的并集 |
SUNIONSTORE destination key [key ...] | 计算给定集合的并集,并将结果存储在 destination 中 |
SDIFF key [key ...] | 返回给定集合之间的差集 |
SDIFFSTORE destination key [key ...] | 计算差集并将结果存储在 destination 中 |
SRANDMEMBER key [count] | 返回集合中一个或多个随机成员 |
SSCAN key cursor [MATCH pattern] [COUNT count] | 迭代集合中的元素(适合处理大集合时分批遍历) |
示例
SADD users "Tom" "Jerry"
SMEMBERS users
SISMEMBER users "Tom"
SREM users "Jerry"
SCARD users
6. 有序集合 (Sorted Set / ZSet)
命令 | 说明 |
---|---|
ZADD key [NX|XX] [CH] [INCR] score member [score member ...] | |
ZREM key member [member ...] | 移除有序集合中的一个或多个成员 |
ZINCRBY key increment member | 为有序集合中的成员的分数加上指定值 |
ZRANGE key start stop [WITHSCORES] | 返回有序集合中指定区间内的成员(按分数从低到高排序) |
ZREVRANGE key start stop [WITHSCORES] | 返回有序集合中指定区间内的成员(按分数从高到低排序) |
ZRANGEBYSCORE key min max [WITHSCORES] [LIMIT offset count] | 返回有序集合中分数在指定范围内的成员 |
ZREVRANGEBYSCORE key max min [WITHSCORES] [LIMIT offset count] | 返回有序集合中分数在指定范围内的成员(从高到低排序) |
ZRANK key member | 返回成员在有序集合中的排名(从 0 开始,按分数从低到高排序) |
ZREVRANK key member | 返回成员在有序集合中的排名(从 0 开始,按分数从高到低排序) |
ZSCORE key member | 返回有序集合中成员的分数 |
ZCARD key | 获取有序集合中的成员数量 |
ZCOUNT key min max | 统计分数在指定范围内的成员数量 |
ZLEXCOUNT key min max | 统计字典序在指定范围内的成员数量(仅适用于分数相同的成员) |
ZRANGEBYLEX key min max [LIMIT offset count] | 返回有序集合中成员的字典序范围内的元素 |
ZREVRANGEBYLEX key max min [LIMIT offset count] | 返回有序集合中成员的字典序范围内的元素(逆序) |
ZPOPMIN key [count] | 移除并返回有序集合中分数最小的成员 |
ZPOPMAX key [count] | 移除并返回有序集合中分数最大的成员 |
ZUNIONSTORE destination numkeys key [key ...] [WEIGHTS weight [weight ...]] [AGGREGATE SUM | MAX | MIN] | 多个有序集合求并集 |
ZINTERSTORE destination numkeys key [key ...] [WEIGHTS weight [weight ...]] [AGGREGATE SUM | MAX | MIN] | 多个有序集合求交集 |
ZSCAN key cursor [MATCH pattern] [COUNT count] | 迭代有序集合中的元素 |
ZMSCORE key member [member ...] | 获取有序集合中多个成员的分数(Redis 6.2 及以上支持) |
示例
java
ZADD ranking 100 "Alice"
ZADD ranking 200 "Bob"
ZRANGE ranking 0 -1 WITHSCORES
ZREM ranking "Alice"
7. 其他操作
命令 | 作用 |
---|---|
FLUSHDB |
清空当前数据库 |
FLUSHALL |
清空所有数据库 |
INFO |
获取服务器统计信息 |
PING |
测试连接 |
特定使用场景操作
1. Geo(地理位置存储与计算)
Redis 的 Geo 用于存储地理位置(经纬度)并提供距离计算、范围查询等功能。
命令 | 作用 |
---|---|
GEOADD key longitude latitude member [longitude latitude member ...] |
添加地理位置信息 |
GEODIST key member1 member2 [unit] |
计算两个位置之间的距离(支持单位:m、km、mi、ft) |
GEOPOS key member [member ...] |
获取指定位置的经纬度 |
`GEORADIUS key longitude latitude radius unit [WITHCOORD] [WITHDIST] [COUNT count] [ASC|DESC]` | |
`GEORADIUSBYMEMBER key member radius unit [WITHCOORD] [WITHDIST] [COUNT count] [ASC|DESC]` | |
GEOHASH key member [member ...] |
获取成员的 GeoHash 值 |
示例
java
GEOADD cities 116.40 39.90 "Beijing"
GEOADD cities 121.47 31.23 "Shanghai"
GEODIST cities "Beijing" "Shanghai" km
GEORADIUS cities 116.40 39.90 100 km WITHDIST
2. HyperLogLog(基数统计)
Redis HyperLogLog 是用于 近似统计不重复元素数量 的数据结构,占用内存固定(12 KB),适用于大规模数据去重计数。
命令 | 作用 |
---|---|
PFADD key element [element ...] |
添加元素到 HyperLogLog |
PFCOUNT key [key ...] |
获取去重后的元素数量估算值 |
PFMERGE destkey sourcekey [sourcekey ...] |
合并多个 HyperLogLog |
示例
java
PFADD users "user1" "user2" "user3"
PFCOUNT users
PFMERGE total_users users1 users2
适用场景 :统计 网站UV、活跃用户数、访问IP数 等。
3. Bitmap(位图)
Bitmap 是 二进制位存储 结构,适用于存储 用户签到、活跃状态、权限控制 等场景。
命令 | 作用 |
---|---|
SETBIT key offset value |
设置某个位的值(1 或 0) |
GETBIT key offset |
获取某个位的值 |
BITCOUNT key [start end] |
统计 key 中值为 1 的位个数 |
BITOP operation destkey key [key ...] |
按位操作(AND、OR、XOR、NOT) |
示例
java
SETBIT sign:20240301 1 1 # 用户ID=1签到
SETBIT sign:20240301 2 1 # 用户ID=2签到
GETBIT sign:20240301 1 # 查询用户ID=1是否签到
BITCOUNT sign:20240301 # 统计今日签到人数
适用场景:用户签到、状态标记、权限控制、唯一性判断。
4. BitField(高级位操作)
BitField 用于操作多个二进制位 (支持批量读写) ,适用于 计数器、标记存储、状态管理。
命令 | 作用 |
---|---|
BITFIELD key GET type offset |
读取某个位置的值 |
BITFIELD key SET type offset value |
设置某个位范围的值 |
BITFIELD key INCRBY type offset increment |
对某个位范围的值进行增减 |
示例
java
BITFIELD user_data SET u8 0 100 # 把偏移量0的8位数值设为100
BITFIELD user_data INCRBY u8 0 5 # 偏移量0的8位数值加5
BITFIELD user_data GET u8 0 # 获取偏移量0的8位值
适用场景:用户计数、状态标记、存储紧凑数据。
5. Scan(游标迭代查询)
SCAN
命令用于 大规模数据迭代查询 ,可以分批遍历 key、集合、哈希、ZSet。
命令 | 作用 |
---|---|
SCAN cursor [MATCH pattern] [COUNT count] |
迭代 key |
HSCAN key cursor [MATCH pattern] [COUNT count] |
迭代 hash |
SSCAN key cursor [MATCH pattern] [COUNT count] |
迭代 set |
ZSCAN key cursor [MATCH pattern] [COUNT count] |
迭代 zset |
示例
java
SCAN 0 MATCH user:* COUNT 10
HSCAN user:1001 0 MATCH name COUNT 5
适用场景 :海量数据分页查询 ,防止 KEYS
阻塞 Redis。