Go math/bits.OnesCount64 怎样统计 64 位整数的置位数

在 Go 里统计一个 64 位整数有多少个二进制位是 1，直接使用 math/bits.OnesCount64 即可。它接收 uint64，返回值是 int，统计的是置位数量，不是整数的十进制大小。

官方文档：https://pkg.go.dev/math/bits#OnesCount64

如果你的数据本来就是 uint64，调用 bits.OnesCount64(mask) 就能得到 0 到 64 之间的置位数；输入为 0 时返回 0，64 个 bit 全为 1 时返回 64。

OnesCount64 的输入和返回值是什么

OnesCount64 的签名是 func OnesCount64(x uint64) int。可以把它理解成“把一个固定宽度的位模式交给统计函数，再取回一个普通整数”。例如权限、特性开关或协议标志常常用一个 uint64 保存多个布尔位。

这里的“置位”就是二进制表示中的 1。例如十进制的 14 写成二进制是 1110，其中有 3 个 1，所以统计结果是 3。函数不会把 14 当成要分解的十进制字符串，也不会返回最高位的位置。

一个位掩码示例怎么写

下面用四个权限位组成一个掩码。示例重点是调用关系，代码中的输出是根据输入值推导出的示意结果，不把它描述成本机运行截图。

package main

import (
	"fmt"
	"math/bits"
)

func main() {
	// 每一位代表一种能力：读、写、导出和审计。
	const (
		canRead uint64 = 1 

这个掩码有三个位被设置，因此 count 的含义是“启用的能力数量”。如果业务还要知道具体是哪几个能力，仍然需要用 mask&canRead != 0 这类判断；OnesCount64 只负责计数。

当输入是运行时拼出的 uint64 时，不需要先转成字符串，也不需要自己循环右移。把计数职责集中到标准库函数，能让“位模式”和“统计结果”两种概念保持分离。

零值、全 1 值和输入类型怎么判断

边界判断可以先看输入类型，再看值的位宽。uint64(0) 没有置位，结果为 0；^uint64(0) 的 64 个 bit 都是 1，结果为 64。返回值使用 int 足以表达 0 到 64 的范围。

不要把任意整数直接塞进 uint64 就当作类型选择完成了：如果原始数据是有符号整数，先明确负数的业务含义，再决定是否按补码位模式转换。否则，负数转换后可能出现大量高位 1，统计结果会与“绝对值有几个 1”完全不同。

package main

import (
	"fmt"
	"math/bits"
)

func main() {
	// 用固定宽度构造边界值，避免依赖平台的 int 大小。
	zero := uint64(0)
	allOnes := ^uint64(0)

	// OnesCount64 只统计 bit 数，返回值仍是 int。
	fmt.Println(bits.OnesCount64(zero))
	fmt.Println(bits.OnesCount64(allOnes))
}

常见误区与延伸问题

• 误区一：把置位数当成最高位下标。置位数是所有 1 的总数，和最高位位置没有直接关系。
• 误区二：用字符串格式化后再数字符。那会混入前导 0、格式化成本和字符串处理，不能替代按位统计。
• 误区三：忽略输入的位宽。uint32 的全 1 结果上限是 32，固定 64 位协议字段应使用 uint64。

OnesCount64 会返回哪些结果

对 uint64 输入，结果范围是 0 到 64。结果越大，只能说明输入中 1 的数量越多，不能直接推出原整数的业务状态。

什么时候使用 OnesCount 而不是 OnesCount64

当变量类型是 uint 且希望让函数跟随平台字长时使用 OnesCount；当协议、文件格式或位掩码明确规定 64 位时，使用 OnesCount64 更直观。

总结一下：先保持输入的位宽语义，再用对应的 math/bits 函数统计置位数。这样既能覆盖 0 和全 1 的边界，也不会把“有多少个 1”和“这个数有多大”混为一谈。