*Redis INCRBY 命令

将 key 中存储的数字值增加指定的整数值。


*语法

INCRBY key increment

*参数说明

参数 类型 必填 说明
key String 键名
increment Integer 增量值,可为负数

*返回值

条件 返回值
递增成功 返回递增后的新值(Integer)
key 不存在 先设为 0 再递增
value 非整数 返回错误

*时间复杂度

O(1)

*

*示例

> SET counter 100
OK
> INCRBY counter 50
(integer) 150

> INCRBY counter -30
(integer) 120

# key 不存在
> INCRBY newcounter 10
(integer) 10

*常见错误

  1. increment 或 value 非整数:返回错误。

*最佳实践

  1. 批量计数:统计批量操作的增量,如批量导入数据量统计。
  2. 负增量递减:INCRBY key -N 等价于 DECRBY key N。

*FAQ

Q: INCRBY 和 INCR 有什么区别? A: INCR 固定 +1;INCRBY 可指定任意整数增量。

Q: INCRBY 可以减吗? A: 可以,increment 为负数即可递减。