Redis BITCOUNT 怎样统计字符串中的置位数量

Redis 的位图并不是独立的数据类型，而是建立在字符串值的 bit 上。要统计其中有多少个 bit 被置为 1，直接使用 BITCOUNT key 即可；需要缩小范围时，再补上包含端点的 start end。Redis 7.0 及以上还可以用 BYTE 或 BIT 明确下标单位。

官方地址：https://redis.io/docs/latest/commands/bitcount/

最常见的写法是 BITCOUNT key。它返回整型的置位数量，不是字符串长度；不存在的 key 按空字符串处理，返回 0。

先看版本变化：默认是 BYTE，Redis 7.0 才增加 BIT

BITCOUNT 从 Redis 2.6.0 起可用，核心职责始终是对字符串做 population counting，也就是数出值中为 1 的 bit。没有范围参数时，会检查整个字符串。

容易混淆的是范围参数的单位。传统写法：

• BITCOUNT key start end：start 和 end 按字节下标解释；
• BITCOUNT key start end BYTE：显式声明按字节下标解释；
• BITCOUNT key start end BIT：Redis 7.0 及以上按 bit 下标解释。

所以旧客户端或旧 Redis 服务端只需要使用 BYTE 语义时，可以保留三参数写法；如果文章或代码依赖 BIT 选项，则迁移时要先确认服务端版本以及客户端是否能透传这个参数。

用最小命令统计整个字符串或字节区间

下面的示例用 ASCII 字符串帮助理解返回值。它只是命令用法示意，不代表某个线上实例的输出。

# 准备一个字符串值，BITCOUNT 会统计其中所有为 1 的 bit
redis-cli SET bit-demo foobar
redis-cli BITCOUNT bit-demo

# 只统计第 0 个字节；start 和 end 都是包含端点
redis-cli BITCOUNT bit-demo 0 0 BYTE

# 统计第 1 到第 2 个字节，默认 BYTE 也可以省略
redis-cli BITCOUNT bit-demo 1 2

判断范围时记住两个规则：

1. start 和 end 是闭区间，写成 0 0 仍然会统计一个字节；
2. BYTE 模式下，下标针对字符串的字节，不针对中文字符或业务字段。

如果字符串中保存的是 UTF-8 文本，BITCOUNT 仍然按原始字节计数。它回答的是“这些字节展开后有多少个 1”，不是“有多少个字符”，也不是“有多少个用户”。

用 BIT 选项统计位偏移区间

当业务下标本身就是 bit，例如一个用户一天对应一个位置，BYTE 范围就不够直观。Redis 7.0 之后可以把同一组 start end 标记为 BIT：

# 统计从第 5 个 bit 到第 12 个 bit 的置位数量，范围包含 5 和 12
redis-cli BITCOUNT bit-demo 5 12 BIT

# -1 表示最后一个 bit，适合从位图尾部计算一个区间
redis-cli BITCOUNT bit-demo -8 -1 BIT

BYTE 与 BIT 的区别不是结果类型变化，而是区间解释方式变化。比如同样写 0 0，BYTE 模式会检查第一个字节的 8 个 bit；BIT 模式只检查第一个 bit。把这两种写法混在一起，结果就会看起来“少了很多”或“多了很多”。

负数下标也随单位变化：BYTE 模式的 -1 是最后一个字节，BIT 模式的 -1 是最后一个 bit。范围仍然是闭区间。

空键、计数结果和大位图的成本

BITCOUNT 的返回值是整数，表示被置为 1 的 bit 数量。不存在的 key 会按空字符串处理，因此返回 0。这个语义很方便，但也意味着“键不存在”和“键存在但全部为 0”在本次查询中得到相同数字；如果业务要区分两者，需要另用 EXISTS 或保存状态字段。

官方命令文档将复杂度记为 O(N)，N 是被扫描的范围。对小型位图，直接全量统计通常足够；对很大的字符串，应该优先考虑以下取舍：

官方文档还给出了分段统计再在客户端累加的思路。它适合必须扫描大位图、但又不希望一次命令覆盖全部数据的场景；如果只是为了展示一个高频总数，维护一个伴随计数值通常更省读取成本。

迁移时的速查清单

1. 先确认代码是在统计 bit 数量，而不是字符串长度或字符数量。
2. 没有范围时使用 BITCOUNT key；有范围时写清楚是 BYTE 还是 BIT。
3. 检查 Redis 版本：BIT 选项从 Redis 7.0 开始提供。
4. 确认 start、end 是闭区间，并把负索引按字节或 bit 的单位解释。
5. 如果 0 具有业务意义，额外区分“不存在键”和“存在但全为 0”。
6. 对大位图评估 O(N) 扫描，必要时缩小范围、分段累加或维护计数值。

BITCOUNT 返回 0 就代表位图为空吗？

不一定。不存在的 key 会返回 0，存在但所有 bit 都是 0 也返回 0；需要区分时单独检查 key 是否存在。

为什么写了同样的范围，BYTE 和 BIT 结果不同？

因为两者的下标单位不同。BYTE 的 0 0 表示第一个字节，BIT 的 0 0 表示第一个 bit，范围都包含端点。

Redis 7.0 之前怎样统计某一段 bit？

旧版本没有 BIT 范围选项，可以按字节范围读取后在客户端处理，或调整数据布局；不要把 bit 下标直接传给旧版本的 BYTE 参数。