Redis 与缓存 / 系统课时
使用 Bitfield 处理整数位段
使用 Bitfield 处理整数位段
本课解决多个小整数各占一个普通 Redis 键所带来的内存浪费。你将使用 BITFIELD 在字符串中定义定长整数位段,完成读取、写入、递增,并控制溢出后的处理方式。
学习目标
- 使用有符号或无符号整数位段
- 按绝对偏移或字段编号读写数据
- 配置回绕、饱和与失败三种溢出策略
位段与偏移规则
BITFIELD 支持 iN 有符号整数和 uN 无符号整数,例如 i8、u16。偏移可直接写位位置,也可使用 #编号;#1 表示按当前字段宽度跳过一个字段。
例如连续两个 u8 字段共占 16 位。第一个字段使用 #0,第二个字段使用 #1,适合保存等级、次数或小范围状态值。混用不同位宽时,显式位偏移通常更容易审查。

写入并读取两个整数
下面把两个无符号 8 位整数写入同一个键,再把第一个字段增加 200。由于配置了 SAT,超过 255 后会停在上限。
bash
redis-cli DEL demo:bitfield:0803 >/dev/null
redis-cli --raw BITFIELD demo:bitfield:0803 SET u8 '#0' 120 SET u8 '#1' 30
redis-cli --raw BITFIELD demo:bitfield:0803 GET u8 '#0' GET u8 '#1'
redis-cli --raw BITFIELD demo:bitfield:0803 OVERFLOW SAT INCRBY u8 '#0' 200
redis-cli --raw BITFIELD demo:bitfield:0803 GET u8 '#0' GET u8 '#1'预期输出:
text
0
0
120
30
255
255
30SET 返回旧值,所以首次写入得到两个 0。最后一个字段仍为 30,说明每个子命令只作用于指定的位段。
三种溢出策略
默认 WRAP 会按整数宽度回绕,例如无符号 8 位的 255 再加 1 变为 0。SAT 会限制在最小值或最大值;FAIL 在溢出时不修改字段,并为该子命令返回空值。
OVERFLOW 只影响它后面的 INCRBY 子命令,同一条命令中可以切换策略。业务计数器通常使用 SAT 或 FAIL,避免回绕后产生看似正常但含义错误的值。
适用场景与限制
Bitfield 适合字段宽度明确、取值范围稳定且访问模式简单的紧凑数据,例如游戏角色小属性、设备状态字或限幅计数器。
它不提供字段名和结构版本。位宽或布局变更后,旧数据可能被错误解释,因此应把版本写进键名,或维护明确的编码协议。需要频繁增删字段、复杂查询或审计时,Hash 通常更易维护。
按自己的节奏,确认真正理解。