首页/数据/数据库速查/ZADD 有序集合写入(NX/XX/GT/LT/CH/INCR)
Redis 命令96 条

ZADD 有序集合写入(NX/XX/GT/LT/CH/INCR)

ZSet 按 score 排序的去重集合:ZADD 支持 NX(只新增)、XX(只更新)、GT/LT(分数比较)、CH(返回变动数)、INCR(自增模式)。

数据库速查数据更新于 2026-10-12
用途添加成员并设置分数
语法ZADD key [NX|XX] [GT|LT] [CH] [INCR] score member [score member ...]
返回普通模式=新增成员数;CH 模式=变更数;INCR 模式=新分数

常用组合

常用组合
ZADD rank 100 u1 200 u2        # 返回 2
ZADD rank XX 150 u1            # 只更新已有成员,返回 0/1
ZADD rank NX 300 u3            # 只新增,已存在不动
ZADD rank GT CH 180 u1         # 仅当新分更大才更新,CH 返回 1
ZADD rank INCR 10 u1           # 分数 +10,返回新分数
GT/LT 与 NX 互斥、INCR 与其他多元素组合互斥:一次只能用一种语义,写错直接报错。

易错点

  • 以为 ZADD 会覆盖分数为 0 或忽略大小:默认每次写入都直接覆盖分数
  • GA/GT 混用报错:GT 表示「大于才更新」,别当成 GET 之类的缩写

数据来源与参考

  • Redis 官方文档: ZADD

相关工具

​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌