本文介绍如何将 Redis 使用 SETBIT 命令写入的二进制字符串（如 "@"）解包为 Go 中的 []bool，提供高效、可读性强的位解析实现，并附完整示例与关键注意事项。
本文介绍如何将 redis 使用 `setbit` 命令写入的二进制字符串（如 `"@"`）解包为 go 中的 `[]bool`，提供高效、可读性强的位解析实现，并附完整示例与关键注意事项。
Redis 的 SETBIT 命令以字节为单位操作底层位数组，GET 返回的是原始字节序列（即 []byte），每个字节对应 8 个连续比特位，高位在前（big-endian within byte）——这是解析时最关键的约定。例如，执行 SETBIT mykey 1 1 后，第 1 位（0-indexed）被置为 1，对应字节中第 7 位（从左数第 2 位），其 ASCII 表示可能为 "@"（十进制 64，二进制 01000000）。
Go 标准库及主流 Redis 客户端（如 Redigo）均未内置位字符串解包工具。以下是一个生产就绪的解析函数，兼顾清晰性与性能：
// hasBit 检查字节 n 的第 pos 位（0-indexed，从最低位 LSB 开始计数）
func hasBit(n byte, pos uint) bool {
return n&(1<<pos) != 0
}
// getBitSet 将 Redis GET 返回的字节切片解析为 []bool
// 返回切片索引即对应全局 bit 位置（0-indexed），长度 = len(src) * 8
func getBitSet(src []byte) []bool {
bits := make([]bool, len(src)*8)
for byteIdx, b := range src {
// 遍历字节内 8 位：j=7 → j=0 对应 MSB → LSB（即 Redis 位序）
for j := 7; j >= 0; j-- {
globalBitIdx := byteIdx*8 + (7 - j) // 全局位索引：0,1,2,...
bits[globalBitIdx] = hasBit(b, uint(j))
}
}
return bits
}使用示例如下（基于 Redigo）：
conn := /* your redis connection */
defer conn.Close()
// 设置位：bit 1 = 1, bit 5 = 1
_, _ = conn.Do("SETBIT", "mykey", 1, 1)
_, _ = conn.Do("SETBIT", "mykey", 5, 1)
// 获取原始字节
raw, err := redis.Bytes(conn.Do("GET", "mykey"))
if err != nil {
log.Fatal(err)
}
// 解析为布尔切片
bits := getBitSet(raw)
fmt.Printf("Total bits: %d\n", len(bits)) // 输出：8（因至少需 1 字节存 bit 5）
for i, b := range bits {
fmt.Printf("Bit %d = %t\n", i, b)
}
// 输出示例：
// Bit 0 = false
// Bit 1 = true ← 由 SETBIT mykey 1 1 设置
// ...
// Bit 5 = true ← 由 SETBIT mykey 5 1 设置⚠️ 关键注意事项：
- 位序一致性：Redis 内部按“字节内高位在前”存储（即 bit 0 是最高位），本实现严格遵循该约定；若误用 LSB-first 逻辑，结果将完全错误。
- 内存安全：getBitSet 输入为空切片时返回空 []bool，无需额外判空。
- 扩展性：若需处理超大位集（如百万级 bit），可考虑流式解析或 []uint64 分块优化，但对常规场景 []bool 已足够清晰。
- 错误处理：实际项目中应检查 redis.Bytes() 的 err，避免 panic；示例中省略以突出核心逻辑。
通过此方案，开发者可无缝桥接 Redis 的紧凑位存储与 Go 的语义化布尔操作，为布隆过滤器、权限位图、实时状态聚合等场景提供坚实基础。
