Redis语法大全
一、String(字符串)
特点:单键值存储,值可为字符串、数字,支持原子操作。
常用命令
-
SET
- 语法:
SET key value [EX seconds] [PX milliseconds] [NX|XX]
- 说明:设置键值对,可指定过期时间(
EX
秒,PX
毫秒),NX
(仅键不存在时设置)或XX
(仅键存在时设置)。 - 示例:
bash
SET name "John" EX 60 # 设置键"name"的值为"John",60秒后过期 SET age 25 NX # 若"age"不存在则设置为25
- 语法:
-
GET
- 语法:
GET key
- 说明:获取键对应的值。
- 示例:
bash
GET name # 输出:"John"
- 语法:
-
INCR/INCRBY/DECR/DECRBY
- 语法:
bash
INCR key # 自增1 INCRBY key increment # 自增指定值 DECR key # 自减1 DECRBY key decrement # 自减指定值
- 示例:
bash
SET counter 10 INCR counter # 结果:11 INCRBY counter 5 # 结果:16
- 语法:
-
STRLEN
- 语法:
STRLEN key
- 说明:获取字符串值的长度。
- 示例:
bash
STRLEN name # 输出:4("John"长度为4)
- 语法:
-
GETSET
- 语法:
GETSET key new_value
- 说明:获取旧值并设置新值(原子操作)。
- 示例:
bash
GETSET counter 0 # 输出旧值16,同时设置为0
- 语法:
二、Hash(哈希)
特点:键值对集合,用于存储对象(如用户信息)。
常用命令
-
HSET/HSETNX
- 语法:
bash
HSET key field value [field value ...] # 设置单个或多个字段 HSETNX key field value # 仅字段不存在时设置
- 示例:
bash
HSET user:1 name "Alice" age 30 # 设置用户1的姓名和年龄 HSETNX user:1 gender "female" # 若"gender"不存在则设置
- 语法:
-
HGET/HMGET
- 语法:
bash
HGET key field # 获取单个字段值 HMGET key field1 field2 # 获取多个字段值
- 示例:
bash
HGET user:1 name # 输出:"Alice" HMGET user:1 name age # 输出:"Alice" "30"
- 语法:
-
HGETALL
- 语法:
HGETALL key
- 说明:获取所有字段和值。
- 示例:
bash
HGETALL user:1 # 输出:name "Alice" age "30" gender "female"
- 语法:
-
HINCRBY
- 语法:
HINCRBY key field increment
- 说明:对字段值进行数值增减。
- 示例:
bash
HINCRBY user:1 age 1 # 年龄+1,结果为31
- 语法:
-
HDEL
- 语法:
HDEL key field [field ...]
- 说明:删除一个或多个字段。
- 示例:
bash
HDEL user:1 gender # 删除"gender"字段
- 语法:
三、List(列表)
特点:有序、可重复的字符串列表,按插入顺序排序,支持头部(左)和尾部(右)操作。
常用命令
-
LPUSH/RPUSH
- 语法:
bash
LPUSH key value [value ...] # 从头部插入元素 RPUSH key value [value ...] # 从尾部插入元素
- 示例:
bash
LPUSH fruits apple # 列表:["apple"] RPUSH fruits banana # 列表:["apple", "banana"] LPUSH fruits orange # 列表:["orange", "apple", "banana"]
- 语法:
-
LPOP/RPOP
- 语法:
bash
LPOP key # 从头部弹出元素(删除并返回) RPOP key # 从尾部弹出元素
- 示例:
bash
LPOP fruits # 输出:"orange",列表变为["apple", "banana"]
- 语法:
-
LRANGE
- 语法:
LRANGE key start stop
- 说明:获取列表指定区间的元素(索引从 0 开始,
-1
表示最后一个元素)。 - 示例:
bash
LRANGE fruits 0 -1 # 输出所有元素:["apple", "banana"] LRANGE fruits 0 1 # 同上
- 语法:
-
LLEN
- 语法:
LLEN key
- 说明:获取列表长度。
- 示例:
bash
LLEN fruits # 输出:2
- 语法:
-
LREM
- 语法:
LREM key count value
- 说明:删除列表中前
count
个值为value
的元素(count>0
从头部删,count<0
从尾部删,count=0
删所有)。 - 示例:
bash
RPUSH nums 1 2 2 3 LREM nums 2 2 # 删除前2个"2",列表变为[1, 3]
- 语法:
四、Set(集合)
特点:无序、唯一的字符串集合,支持交集、并集、差集运算。
常用命令
-
SADD
- 语法:
SADD key member [member ...]
- 说明:向集合中添加一个或多个元素(重复元素自动忽略)。
- 示例:
bash
SADD colors red blue green SADD colors red # 无效,red已存在
- 语法:
-
SMEMBERS
- 语法:
SMEMBERS key
- 说明:获取集合所有成员。
- 示例:
bash
SMEMBERS colors # 输出:red blue green(顺序不固定)
- 语法:
-
SISMEMBER
- 语法:
SISMEMBER key member
- 说明:检查成员是否存在(存在返回 1,否则 0)。
- 示例:
bash
SISMEMBER colors yellow # 输出:0
- 语法:
-
SINTER/SUNION/SDIFF
- 语法:
bash
SINTER key1 key2 ... # 交集 SUNION key1 key2 ... # 并集 SDIFF key1 key2 ... # 差集(key1 - key2)
- 示例:
bash
SADD set1 a b c SADD set2 b c d SINTER set1 set2 # 输出:b c(交集) SUNION set1 set2 # 输出:a b c d(并集) SDIFF set1 set2 # 输出:a(set1独有的元素)
- 语法:
-
SREM
- 语法:
SREM key member [member ...]
- 说明:删除集合中的一个或多个元素。
- 示例:
bash
SREM colors blue # 删除blue
- 语法:
五、Sorted Set(有序集合)
特点:每个元素关联一个分数(score
),按分数排序,成员唯一。
常用命令
-
ZADD
- 语法:
ZADD key score member [score member ...]
- 说明:添加元素并设置分数。
- 示例:
bash
ZADD scores 85 tom 90 jerry 80 bob
- 语法:
-
ZRANGE/ZREVRANGE
- 语法:
bash
ZRANGE key start stop [WITHSCORES] # 按分数升序获取元素(可带分数) ZREVRANGE key start stop [WITHSCORES] # 按分数降序获取元素
- 示例:
bash
ZRANGE scores 0 -1 WITHSCORES # 升序输出:bob 80 tom 85 jerry 90 ZREVRANGE scores 0 -1 WITHSCORES # 降序输出:jerry 90 tom 85 bob 80
- 语法:
-
ZSCORE
- 语法:
ZSCORE key member
- 说明:获取元素的分数。
- 示例:
bash
ZSCORE scores tom # 输出:85
- 语法:
-
ZCOUNT
- 语法:
ZCOUNT key min max
- 说明:统计分数在
[min, max]
区间内的元素数量。 - 示例:
bash
ZCOUNT scores 80 90 # 输出:3(80、85、90)
- 语法:
-
ZREM
- 语法:
ZREM key member [member ...]
- 说明:删除一个或多个元素。
- 示例:
bash
ZREM scores bob # 删除bob
- 语法:
六、通用命令
-
KEYS
- 语法:
KEYS pattern
- 说明:查找匹配模式的键(
*
通配符,?
单字符,[]
范围)。 - 示例:
bash
KEYS user:* # 匹配所有以"user:"开头的键 KEYS ?ello # 匹配"hello"、"mello"等
- 语法:
-
EXPIRE/PEXPIRE
- 语法:
bash
EXPIRE key seconds # 设置键的过期时间(秒) PEXPIRE key ms # 设置过期时间(毫秒)
- 示例:
bash
EXPIRE name 30 # "name"键30秒后过期
- 语法:
-
TTL/PTTL
- 语法:
bash
TTL key # 获取剩余过期时间(秒,-1表示永久有效,-2表示键不存在) PTTL key # 毫秒单位
- 示例:
bash
TTL name # 输出:25(假设剩余25秒)
- 语法:
-
DEL
- 语法:
DEL key [key ...]
- 说明:删除一个或多个键。
- 示例:
bash
DEL age counter # 删除"age"和"counter"键
- 语法:
七、高级功能命令
-
Pipeline(管道)
- 语法:批量发送命令,减少网络延迟。
- 示例:
bash
redis-cli -p 6379 <<EOF MULTI SET a 1 SET b 2 EXEC EOF
-
Scripting(Lua 脚本)
- 语法:使用
EVAL
执行 Lua 脚本,支持原子操作。 - 示例:累加两个键的值并返回:
bash
EVAL "return redis.call('INCR', KEYS[1]) + redis.call('INCR', KEYS[2])" 2 key1 key2
- 语法:使用
-
Pub/Sub(发布订阅)
- 订阅频道:
SUBSCRIBE channel1 channel2
- 发布消息:
PUBLISH channel "message"
- 示例:
bash
# 终端1:订阅频道 SUBSCRIBE chat# 终端2:发布消息 PUBLISH chat "Hello Redis!"
- 订阅频道:
八、注意事项
- 数据类型选择:
- String:计数器、缓存单个值。
- Hash:存储对象(如用户信息)。
- List:消息队列(LPUSH + RPOP)、最新列表。
- Set:去重、标签系统、交集 / 并集运算。
- Sorted Set:排行榜、带权重的队列。
- 键命名规范:建议使用
类型:ID:字段
格式(如user:1:name
),便于管理。 - 性能优化:避免使用
KEYS *
等全量扫描命令,可改用SCAN
增量遍历。