首页/数据/数据库速查/INCR / DECR / INCRBY 原子计数
Redis 命令96 条

INCR / DECR / INCRBY 原子计数

原子自增自减:计数、库存、限流、发号都能用;INCRBYFLOAT 支持小数(内部转科学计数,精度受浮点限制)。

数据库速查数据更新于 2026-10-12
用途字符串值原子加减
语法INCR key / DECR key / INCRBY key n / DECRBY key n / INCRBYFLOAT key f
返回运算后的新值

示例

示例
SET pv 0
INCR pv          # 1
INCRBY pv 100    # 101
DECRBY pv 1      # 100
INCRBYFLOAT price 19.9   # "19.9"
# 计数器+过期:限流入口
INCR api:limit:1001:2026101212
EXPIRE api:limit:1001:2026101212 70   # 或 INCR 后判断 ==1 时设过期
值不是数字或超 64 位整数范围会报错(ERR value is not an integer or out of range);INCR 前最好 SET 初值或容错初始化。

易错点

  • INCR 不存在的键会当 0 开始自增:业务没设初值时第一次结果符合预期但语义可能错
  • INCRBYFLOAT 有浮点累积误差,金额类场景慎用

数据来源与参考

  • Redis 官方文档: INCR
  • Redis 官方文档: INCRBYFLOAT

相关工具

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