Go net.IPMask.Size 怎样判断掩码是否是连续前缀

我第一次把 IP 白名单从字符串改成 net.IPNet 时，最容易误判的就是 net.IPMask.Size() 返回的两个零。这个方法不是简单地数 1 的个数，而是在判断掩码是否符合“前面连续是 1，后面连续是 0”的规范形状。连续掩码会返回前缀长度和总位数；非连续掩码返回 (0, 0)。但合法的 IPv4 /0 返回的是 (0, 32)，不能混为一谈。

调用Go标准库的`mask.Size()`方法会返回两个整数，第一个是前缀位长度，第二个是掩码总有效位长度，如果返回的错误值为nil，就说明当前IPMask是连续的前缀掩码，非连续掩码会直接返回size为0和对应的错误信息。

先把 Size 的两个返回值看懂

官方定义很直接：Size 返回掩码的前导 1 数量和总位数；如果掩码不是“1 后跟 0”的规范形式，就返回 0, 0。因此它同时回答两个问题：这个掩码有多长，以及它能不能被解释成 CIDR 前缀。

这里的数字是语义基线，不是压测数据。255.255.255.0 的基线是 24/32，代表 IPv4 的 /24；IPv6 的 /64 则是 64/128。这组数字比把掩码转成字符串再手工统计更稳定，也不会把 IPv4 和 IPv6 的宽度混在一起。

用 IPv4 和 IPv6 掩码做一次对照

构造标准掩码时，net.IPv4Mask 适合表达 4 字节 IPv4 掩码，net.CIDRMask 适合按前缀长度构造 IPv4 或 IPv6 掩码。它们都能和 Size 互相对照：前缀长度是 ones，地址族宽度是 bits。

package main

import (
    "fmt"
    "net"
)

func main() {
    ipv4Mask := net.IPv4Mask(255, 255, 255, 0)
    ones4, bits4 := ipv4Mask.Size()
    fmt.Printf("IPv4: %d/%d\n", ones4, bits4) // 输出前缀长度和 IPv4 总位数

    ipv6Mask := net.CIDRMask(64, 128)
    ones6, bits6 := ipv6Mask.Size()
    fmt.Printf("IPv6: %d/%d\n", ones6, bits6) // 输出 IPv6 的 /64 语义
}

这段代码对应的结果应当是 IPv4: 24/32 和 IPv6: 64/128。如果业务只接收 IPv4，就可以把 bits 固定约束为 32；如果同时接收两种地址族，就应保留这个返回值，不要只保存 ones。

(0, 0) 到底代表什么

(0, 0) 的含义是“无法按规范的连续前缀解释”。例如 11111111 00001111 00000000 00000000 在第一个 0 后又出现了 1，它不是标准 CIDR 掩码，Size 就不会把它猜成某个前缀。

反过来，合法的全零 IPv4 掩码是 /0，结果应是 (0, 32)；全零 IPv6 掩码是 (0, 128)。所以分类时应先用 bits == 0 识别非规范形状，再接受 ones == 0 但 bits > 0 的合法零前缀。

封装一个不会误判 /0 的分类函数

如果这个判断会出现在配置加载或白名单解析里，建议集中封装，避免多个调用点各自猜测 (0, 0) 的含义。函数可以同时返回前缀长度、地址族宽度和是否为连续掩码。

package netmask

import "net"

// PrefixInfo 把 Size 的两个整数转换成调用方容易判断的结果。
type PrefixInfo struct {
    Ones int  // 连续前缀中的 1 数量
    Bits int  // IPv4 为 32，IPv6 为 128
    Valid bool // 是否为 1 后跟 0 的规范掩码
}

func Inspect(mask net.IPMask) PrefixInfo {
    ones, bits := mask.Size()
    // bits 为 0 是 Size 表示的非规范形状；ones 为 0 不一定错误，/0 仍合法。
    return PrefixInfo{Ones: ones, Bits: bits, Valid: bits != 0}
}

这段封装只判断掩码形状，不判断它是否和某个 IP 属于同一个网络。后一个问题应交给 net.IPNet 的 Contains；不要把“掩码连续”误当成“地址匹配成功”。

排查时记住这张小表

我的实际判断顺序是：先看 bits 是否为 0，再按 32 或 128 判断地址族，最后使用 ones 作为前缀长度。这样既保留了零前缀，也能把非规范掩码尽早挡在配置边界之外。

常见追问

Size 返回 (0, 0) 能当成 IPv4 /0 吗？

不能。IPv4 /0 的总位数仍然是 32，正确结果是 (0, 32)；(0, 0) 表示无法识别为规范连续掩码。

只保存 ones 可以吗？

只有在地址族已经由外部字段严格确定时才勉强可行。通用代码应同时保存 bits，否则 IPv4 /24 与其他地址族的同名数字容易被错误比较。