Go math/bits.TrailingZeros64 怎样处理零值与位图扫描

用 Go 扫描权限位、特性开关或资源占用位图时，math/bits.TrailingZeros64 返回的是最低置位右侧连续零位的数量。最容易漏掉的边界是：传入值为 0 时没有任何置位，它返回 64，这个结果只能当作“空位图”哨兵，不能当作第 64 位去访问数组。

TrailingZeros64 返回什么：先处理零值，再读最低置位

把一个 uint64 看成从右到左编号的 64 个位置，最低置位就是最靠右的 1。例如某个值的二进制末尾有 3 个 0，它的最低置位就在第 3 位，函数返回 3。如果值是 1，返回 0；如果值是 0，返回 64。

因此，最稳妥的判断顺序是先检查 x != 0，再把返回值转成位编号。下面的示例只展示 API 语义，注释说明了零值和数组访问的边界：

package main

import "math/bits"

func lowestBitIndex(x uint64) (int, bool) {
	// 零值没有有效置位，不能把 64 当成数组下标。
	if x == 0 {
		return 0, false
	}
	// 非零输入的结果一定落在 0..63。
	return bits.TrailingZeros64(x), true
}

用 TrailingZeros64 循环提取所有置位

只找一个位置时，读取一次返回值就够了；要遍历全部置位，可以在每轮保存索引，再清除当前最低置位。x & (x - 1) 不改变更高位，只会移除最右侧的那个 1，所以循环次数等于置位数量，而不是固定 64 次。

package main

import "math/bits"

func setBitIndexes(bitmap uint64) []int {
	indexes := make([]int, 0, bits.OnesCount64(bitmap))
	for bitmap != 0 {
		// 读取最低置位编号；此处 bitmap 已排除零值。
		index := bits.TrailingZeros64(bitmap)
		indexes = append(indexes, index)
		// 清掉刚处理的最低置位，保留其余待扫描位置。
		bitmap &= bitmap - 1
	}
	return indexes
}

这个实现返回升序位编号，例如位图同时打开第 1、4、9 位时，结果是 [1 4 9]。如果业务需要的是资源 ID，而不是位编号，应在收集后再做映射，避免把“第几位”和“第几个资源”混在一起。

把位编号映射到业务数据时检查三个边界

如果位图来自网络或文件，先确认解析结果确实是 uint64，不要先转成有符号整数再判断负数。对外部输入还应限制映射表长度，并在索引超界时返回错误；TrailingZeros64 本身只负责位运算，不知道你的资源表是否完整。

常见问题：零值、性能与可读性怎么取舍

TrailingZeros64(0) 能不能直接当成“没有结果”？

可以把返回值 64 作为内部哨兵，但更推荐先判断输入为零并返回明确的布尔值或空切片，让调用者不必记住 64 的特殊含义。

为什么不直接从第 0 位循环检查到第 63 位？

固定扫描更直观，但会遍历大量空位；清除最低置位的循环只处理实际打开的位，适合稀疏位图。若位图通常接近全满，两者差异应以基准测试为准。

返回值能不能直接作为资源数组下标？

只有在资源表与位图严格保持同一套 0 基位置、且长度覆盖 64 位时才可以。否则先做范围检查和版本映射，特别要单独处理空位图。