Go net.IP.DefaultMask 怎样获取 IPv4 的默认掩码

如果你手里已经有一个 net.IP，想快速得到它的“默认掩码”，直接调用 ip.DefaultMask() 即可。但要先记住一个关键边界：它只对能转换为 IPv4 的地址返回掩码，IPv6、空值和非法长度都会得到 nil。返回的也不是现代网络配置推导出的真实网段，而是按 IPv4 首字节套用 A/B/C 类默认掩码。

官方地址：https://pkg.go.dev/net#IP.DefaultMask

DefaultMask 返回什么

DefaultMask 的实现先调用 To4。转换成功后读取 IPv4 的第一个字节：小于 0x80 返回 /8，小于 0xC0 返回 /16，其余有效 IPv4 返回 /24。因此它适合解释旧式 classful 默认值，不适合猜测某个业务网段。

先用 To4 确认输入边界

net.IP 底层是字节切片，IPv4 既可能以 4 字节形式存在，也可能是 16 字节的 IPv4-mapped IPv6 形式。只要 To4 能识别，DefaultMask 就会继续计算；纯 IPv6 则不能获得默认掩码。

package main

import (
    "fmt"
    "net"
)

func main() {
    samples := []string{"10.2.3.4", "172.16.8.9", "192.0.2.1", "2001:db8::1", "not-an-ip"}
    for _, text := range samples {
        // ParseIP 失败时返回 nil；先判断 To4，避免把 IPv6 当成 IPv4 使用。
        ip := net.ParseIP(text)
        if ip == nil || ip.To4() == nil {
            fmt.Printf("%-16s -> 没有 IPv4 默认掩码\\n", text)
            continue
        }

        // DefaultMask 返回的是旧式 A/B/C 类默认掩码。
        mask := ip.DefaultMask()
        ones, bits := mask.Size()
        fmt.Printf("%-16s -> %s, /%d (%d bits)\\n", text, mask, ones, bits)
    }
}

这里的 To4 判断不是多余的：它把“地址是否真的能按 IPv4 解释”从“字符串是否非空”中分离出来。正常的 IPv4-mapped IPv6 也会进入默认掩码分支，纯 IPv6 和解析失败值则提前结束。

用首字节理解 /8、/16、/24

下面三个例子能直观看到返回值。10.2.3.4 的首字节小于 128，返回 255.0.0.0；172.16.8.9 落在 B 类范围，返回 255.255.0.0；192.0.2.1 及更高首字节落入 C 类分支，返回 255.255.255.0。

package main

import (
    "fmt"
    "net"
)

func main() {
    for _, text := range []string{"10.2.3.4", "172.16.8.9", "192.0.2.1"} {
        // ParseIP 得到 16 字节表示时，DefaultMask 仍会先通过 To4 识别 IPv4。
        ip := net.ParseIP(text)
        mask := ip.DefaultMask()
        ones, bits := mask.Size()
        fmt.Printf("%s -> %s -> /%d (%d)\\n", text, mask, ones, bits)
    }
}

IPMask.Size 返回前导 1 的数量和总位数。对于规范的 IPv4 掩码，结果分别是 8, 32、16, 32 和 24, 32。如果掩码不是连续的前导 1 形式，Size 会返回 0, 0，因此它也可以作为读取掩码时的快速检查。

为什么 IPv6 和非法输入会得到 nil

官方实现明确只为 IPv4 提供默认掩码。纯 IPv6 没有 A/B/C 类默认掩码，因此 DefaultMask 返回 nil；同样，长度不正确或没有成功解析成 IPv4 的地址也会返回 nil。不要直接对可能为 nil 的掩码调用 Size 后再把结果当作有效网段。

package main

import (
    "fmt"
    "net"
)

func main() {
    // 这些输入不应被强行套用 IPv4 默认掩码。
    for _, ip := range []net.IP{
        net.ParseIP("2001:db8::1"),
        net.IP{192, 0, 2},
        nil,
    } {
        mask := ip.DefaultMask()
        if mask == nil {
            fmt.Println("没有可用的 IPv4 默认掩码")
            continue
        }
        fmt.Println(mask)
    }
}

现代 CIDR 网段不要依赖 DefaultMask

现实配置通常是 192.0.2.0/27、10.20.0.0/20 这类 CIDR，而不是根据地址首字节推断 /8、/16、/24。此时应该用 net.ParseCIDR 解析带前缀的网段，或者用 net.CIDRMask 明确创建掩码，再交给 IPNet.Contains 判断地址是否属于该网段。

package main

import (
    "fmt"
    "net"
)

func main() {
    // CIDR 前缀表达业务网段，不让 DefaultMask 替我们猜测范围。
    _, network, err := net.ParseCIDR("192.0.2.0/27")
    if err != nil {
        fmt.Println("网段解析失败：", err)
        return
    }

    candidate := net.ParseIP("192.0.2.17")
    fmt.Println("是否属于网段：", network.Contains(candidate))

    // 也可以直接创建 /20 掩码，再配合 IP.Mask 或 IPNet 使用。
    mask := net.CIDRMask(20, 32)
    fmt.Println("明确创建的掩码：", mask)
}

常见误区

• 把 /24 当成真实网段。 DefaultMask 只是旧式默认值，不代表服务器所在网络的实际前缀。
• 忽略 IPv4-mapped IPv6。 16 字节并不自动等于纯 IPv6，先看 To4 是否成功。
• 对 nil 掩码继续做位运算。 先判断返回值，再决定是提示输入不支持，还是改用 CIDR。
• 用 DefaultMask 替代 ParseCIDR。 需要业务网段匹配时，前缀必须来自配置或协议，而不是地址首字节。

小结

net.IP.DefaultMask 的核心规则很简单：先用 To4 确认 IPv4，再按首字节返回 /8、/16 或 /24；不能识别为 IPv4 时返回 nil。它适合兼容旧式默认掩码或解释遗留代码。新代码若要表达可控网段，应优先使用 ParseCIDR、CIDRMask 和 IPNet.Contains。

相关问题

DefaultMask 能判断私网地址吗？

不能。它只返回默认掩码，不负责判断 RFC 1918 私网范围。私网判断应使用专门的地址分类逻辑，并且不要把“有默认掩码”理解成“地址可直接访问”。

IPv6 应该用什么替代 DefaultMask？

使用明确的 IPv6 CIDR 前缀，例如 net.ParseCIDR("2001:db8::/48")，或调用 net.CIDRMask(48, 128) 创建 128 位掩码。