Redis 常用命令之基础、进阶与场景化实战案例

# 设置键值（覆盖原有值）
SET name "张三"
# 设置键值并指定过期时间（30秒）
SETEX code 30 "8866"
# 获取值
GET name
# 数值自增（+1，仅适用于数字值）
INCR num
# 数值自增指定步长（+5）
INCRBY num 5
# 数值自减（-1）
DECR num
# 追加字符串到原有值末尾
APPEND name " - 程序员"

# 设置Hash的单个字段
HSET user:100 name "李四" age 25
# 设置Hash的多个字段
HMSET user:100 name "李四" age 25 gender "男"
# 获取Hash的单个字段值
HGET user:100 name
# 获取Hash的多个字段值
HMGET user:100 name age
# 获取Hash的所有字段和值
HGETALL user:100
# 获取Hash的所有字段名
HKEYS user:100
# 获取Hash的所有值
HVALS user:100
# 判断Hash的字段是否存在
HEXISTS user:100 age
# 删除Hash的指定字段
HDEL user:100 gender
# 获取Hash的字段数量
HLEN user:100

# 从列表尾部添加元素
RPUSH list:msg "消息1" "消息2"
# 从列表头部添加元素
LPUSH list:msg "消息0"
# 从列表尾部移除并返回元素
RPOP list:msg
# 从列表头部移除并返回元素
LPOP list:msg
# 获取列表指定范围的元素（0=-1表示所有）
LRANGE list:msg 0 -1
# 获取列表长度
LLEN list:msg
# 根据索引获取元素
LINDEX list:msg 1
# 根据索引修改元素
LSET list:msg 1 "修改后的消息2"

# 向集合添加元素
SADD set:tags "Java" "Redis" "MySQL"
# 获取集合所有元素
SMEMBERS set:tags
# 判断元素是否在集合中
SISMEMBER set:tags "Redis"
# 删除集合指定元素
SREM set:tags "MySQL"
# 获取集合元素数量
SCARD set:tags
# 求两个集合的交集（共同元素）
SINTER set:tags1 set:tags2
# 求两个集合的并集（所有元素，去重）
SUNION set:tags1 set:tags2
# 求两个集合的差集（在set1中但不在set2中的元素）
SDIFF set:tags1 set:tags2

# 向有序集合添加元素（score为分数）
ZADD zset:rank 95 "张三" 90 "李四" 98 "王五"
# 获取有序集合所有元素（带分数，默认升序）
ZRANGE zset:rank 0 -1 WITHSCORES
# 获取有序集合所有元素（降序）
ZREVRANGE zset:rank 0 -1 WITHSCORES
# 获取指定元素的分数
ZSCORE zset:rank "张三"
# 增加指定元素的分数（+3）
ZINCRBY zset:rank 3 "张三"
# 获取元素的排名（升序，从0开始）
ZRANK zset:rank "李四"
# 获取元素的排名（降序）
ZREVRANK zset:rank "李四"
# 删除指定元素
ZREM zset:rank "李四"
# 获取集合元素数量
ZCARD zset:rank

# 开启事务
MULTI
# 入队命令（此时不执行，仅记录）
SET order:100 status "paid"
HSET user:100 order_count 1
# 执行事务（所有入队命令原子执行）
EXEC
# 取消事务（放弃所有入队命令）
MULTI
SET a 1
DISCARD  # 事务取消，SET a 1不会执行

# 1. SETNX：设置键（仅当键不存在时成功，返回1=加锁成功，0=已被占用）
# 缺点：若加锁客户端宕机，锁无法释放，需配合过期时间
SETNX lock:order 1
EXPIRE lock:order 30  # 给锁设置30秒过期，避免死锁
# 2. SET（推荐）：原子性设置值+过期时间（解决SETNX+EXPIRE非原子问题）
SET lock:order 1 NX EX 30  
# NX=仅当键不存在时设置；EX=过期时间（秒）；PX=过期时间（毫秒）
# 3. GETSET：获取旧值并设置新值（解锁/锁续期用）
# 解锁逻辑示例：先判断值是否是自己的锁，再删除（伪代码）
if GET lock:order == "my_lock_value" 
  DEL lock:order
# 4. DEL：释放锁（需配合业务逻辑，避免误删其他客户端的锁）
DEL lock:order

# 订阅频道（客户端1）
SUBSCRIBE channel:order_notify  # 订阅order_notify频道
PSUBSCRIBE channel:*            # 订阅所有以channel:开头的频道（通配符）
# 发布消息（客户端2）
PUBLISH channel:order_notify "订单100已支付"  # 向频道发布消息，订阅端实时接收
# 取消订阅
UNSUBSCRIBE channel:order_notify  # 取消指定频道订阅
PUNSUBSCRIBE channel:*            # 取消通配符订阅

# 手动触发RDB快照（阻塞Redis，生产环境建议低峰期执行）
BGSAVE  # 后台异步保存（推荐）；SAVE  # 同步保存（阻塞，慎用）
# 查看持久化配置
CONFIG GET save        # 查看RDB自动保存触发条件（如"900 1"=900秒内至少1个键修改则保存）
CONFIG GET appendonly  # 查看AOF是否开启（yes/no）
# 手动触发AOF重写（压缩AOF日志，减少文件体积）
BGREWRITEAOF  # 后台异步重写（推荐）

# PEXPIRE：设置过期时间（单位：毫秒，适配高精度场景）
PEXPIRE code:1234 60000  # 60秒（60000毫秒）后过期
# EXPIREAT：指定过期时间戳（秒）
EXPIREAT user:100 1735689600  # 键在2025-01-01 00:00:00过期
# PEXPIREAT：指定过期时间戳（毫秒）
PEXPIREAT user:100 1735689600000
# TTL/PTTL：查看剩余过期时间（PTTL返回毫秒）
PTTL code:1234  # 返回剩余毫秒数

# 批量设置多个键值对（原子操作）
MSET name "张三" age 25 email "zhangsan@test.com"
# 批量获取多个键的值（返回顺序与参数一致）
MGET name age email  # 返回 ["张三", "25", "zhangsan@test.com"]
# 批量设置键值+过期时间（Redis 7.0+支持，替代SETEX批量场景）
MSETEX key1 60 "val1" key2 120 "val2"

# 批量设置Hash字段（已提过，补充批量获取优化）
HMSET user:101 name "王五" phone "13800138000" address "北京"
# 批量获取Hash字段（指定多个field，减少网络请求）
HMGET user:101 name phone  # 返回 ["王五", "13800138000"]

# 结合SCAN+DEL实现批量删除（生产环境替代KEYS+DEL）
# 示例：删除所有以temp:开头的键（伪代码）
cursor=0
while true; do
  # 分批获取键
  result=$(redis-cli SCAN $cursor MATCH temp:* COUNT 100)
  # 解析游标和键列表
  cursor=$(echo $result | awk 'NR==1{print $1}')
  keys=$(echo $result | awk 'NR==2{print $0}')
  # 批量删除
  if [ -n "$keys" ]; then
    redis-cli DEL $keys
  fi
  # 游标为0时结束
  if [ $cursor -eq 0 ]; then
    break
  fi
done

# 终端执行管道命令示例（echo + redis-cli --pipe）
echo -e "SET a 1\nINCR a\nGET a" | redis-cli --pipe
# 输出：所有命令执行结果，最终GET a返回2

# EVAL：执行Lua脚本（核心命令）
# 格式：EVAL 脚本 键参数个数 键1 键2 ... 参数1 参数2 ...
# 示例：原子性实现“先判断值再修改”（库存扣减，库存>=1才扣减）
EVAL "local stock = tonumber(redis.call('GET', KEYS[1])) 
      if stock and stock >= 1 then
        redis.call('DECR', KEYS[1])
        return 1  # 扣减成功
      else
        return 0  # 库存不足
      end" 1 stock:1001
# SCRIPT LOAD：预加载Lua脚本（避免重复传输脚本内容）
SCRIPT LOAD "return redis.call('GET', KEYS[1])"  # 返回脚本SHA1值
# EVALSHA：执行预加载的脚本（更高效）
EVALSHA 5332031c6b470dc5a0dd9b4bf2030dea6d65de91 1 stock:1001
# SCRIPT EXISTS：检查脚本是否已加载
SCRIPT EXISTS 5332031c6b470dc5a0dd9b4bf2030dea6d65de91
# SCRIPT FLUSH：清空所有预加载的Lua脚本
SCRIPT FLUSH

# GEOADD：添加地理位置（经度，纬度，位置名称）
GEOADD shop:nearby 116.403874 39.914885 "门店A" 116.410049 39.914575 "门店B"
# GEOPOS：获取指定位置的经纬度
GEOPOS shop:nearby "门店A"  # 返回 [116.403874, 39.914885]
# GEODIST：计算两个位置的距离（单位：m/km/mi/ft）
GEODIST shop:nearby "门店A" "门店B" km  # 返回距离（如0.58km）
# GEORADIUS：根据经纬度范围查找位置（附近的门店）
# 示例：查找经度116.405、纬度39.915，半径1km内的所有门店
GEORADIUS shop:nearby 116.405 39.915 1 km WITHDIST WITHCOORD
# GEORADIUSBYMEMBER：根据已有位置查找附近位置
# 示例：查找门店A周围1km内的所有门店
GEORADIUSBYMEMBER shop:nearby "门店A" 1 km WITHDIST

# SETBIT：设置指定偏移量的位值（0/1）
# 示例：用户1001在第5天签到（偏移量5，值1）
SETBIT sign:1001 5 1
# GETBIT：获取指定偏移量的位值
GETBIT sign:1001 5  # 返回1（已签到），0（未签到）
# BITCOUNT：统计指定范围内值为1的位数量
# 示例：统计用户1001当月（30天）的签到次数
BITCOUNT sign:1001 0 29  # 返回签到天数
# BITOP：位图运算（AND/OR/XOR/NOT）
# 示例：统计同时签到的用户（用户1001和1002的签到交集）
BITOP AND sign:common sign:1001 sign:1002
BITCOUNT sign:common  # 返回共同签到天数

# PFADD：添加元素到HyperLogLog集合
PFADD uv:20260121 "user1001" "user1002" "user1003"
# PFCOUNT：统计集合的基数（不重复元素个数）
PFCOUNT uv:20260121  # 返回3
# PFMERGE：合并多个HyperLogLog集合
# 示例：合并1月21日和1月22日的UV数据
PFMERGE uv:202601 uv:20260121 uv:20260122
PFCOUNT uv:202601  # 返回两天的总独立访客数

# AUTH：认证密码（Redis设置密码后，连接时需认证）
AUTH yourpassword  # 认证成功返回OK，失败返回错误
# SELECT：切换数据库（Redis默认16个库，0-15）
SELECT 1  # 切换到1号库
# PING：测试Redis连接是否正常
PING  # 返回PONG表示连接正常
# QUIT：关闭客户端连接
QUIT
# CONFIG SET/GET：动态修改/查看配置（无需重启Redis）
# 示例：修改最大内存为10GB
CONFIG SET maxmemory 10gb
# 示例：查看AOF开关状态
CONFIG GET appendonly