首页/数据/Redis 进阶速查/BITFIELD 位域计数器
本包目录(421 条)
数据结构与选型42 条
持久化56 条主从与哨兵51 条Cluster 集群44 条内存与管理99 条性能与排障129 条

BITFIELD 位域计数器

在字符串上按任意位宽读写整数字段(u8/i16 等),一次调用可执行多条 GET/INCRBY,适合把多个小计数封装进一个键;溢出行为可选 WRAP/SAT/FAIL。

Redis 进阶速查数据更新于 2026-10-12
语法BITFIELD key [GET type offset | INCRBY type offset incr | OVERFLOW WRAP|SAT|FAIL]
位宽u1~u63、i1~i64
偏移数字为位偏移,#n 按位宽对齐

示例

示例
redis-cli BITFIELD stats INCRBY u8 0 1 INCRBY u8 8 1
redis-cli BITFIELD stats GET u8 0
redis-cli BITFIELD stats OVERFLOW SAT INCRBY u8 0 200
偏移用 # 前缀按字段宽度紧密排列:BITFIELD k INCRBY u8 #0 1 INCRBY u8 #1 1 表示第 0、1 个 8 位字段。

易错点

  • 默认溢出策略是 WRAP(回绕),计数类务必显式设置 SAT 或 FAIL 处理边界
  • 一次多条子命令可减少网络往返,但整条命令仍是单线程执行,长命令照样阻塞

数据来源与参考

  • Redis 官方文档:BITFIELD 命令
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌