Go netip Prefix 怎样计算网段的起止地址

Go 的 netip.Prefix 表示一个 CIDR 网段。要得到网段的起止地址，关键不是把字符串拆开，而是先取前缀长度，再用 Masked() 得到规范化的网络地址，最后根据 IPv4 的 32 位或 IPv6 的 128 位地址宽度计算最后地址。这样既能处理 192.0.2.17/24 这类主机位未归零的输入，也能避免用整数溢出处理 IPv6。

官方文档：https://pkg.go.dev/net/netip#Prefix

最小可用写法是：先检查 p.IsValid()，用 p.Masked() 取网络起始地址，再根据 p.Bits() 和 p.Addr().BitLen() 计算最后地址。Prefix.Addr() 本身不保证已经是网络地址。

Prefix 的三个信息先分开看

Prefix 包含一个地址和一个前缀长度。Addr() 返回保存的地址，Bits() 返回网络位数量；文档规定 IPv4 的范围是 0 到 32，IPv6 的范围是 0 到 128，无效值会返回 -1。Masked() 才会把前缀之外的主机位清零，返回规范形式。

这一区分很重要。PrefixFrom 接收地址和位数时不会自动清掉主机位，因此 Addr() 可能是 192.0.2.17，但 Masked().Addr() 应该是 192.0.2.0。如果把前者直接当成起始地址，展示结果和访问控制记录就会偏离 CIDR 的网络边界。

先检查合法性，再取网络起始地址

生产代码应把无效前缀当成输入错误处理。零值 Prefix{} 没有可用地址，前缀长度超出地址族位数时也不应继续计算。Masked() 对零值或无效前缀会返回零值，所以不能只看它的字符串结果。

package main

import (
    "fmt"
    "net/netip"
)

// 返回规范化后的网络起始地址和前缀长度。
// 先检查 Prefix，避免把无效输入误当成 0.0.0.0/0 或 ::/0。
func networkStart(p netip.Prefix) (netip.Addr, int, error) {
    if !p.IsValid() {
        return netip.Addr{}, 0, fmt.Errorf("无效前缀: %q", p.String())
    }
    masked := p.Masked()
    // Bits 记录网络位数量，Masked().Addr() 是清掉主机位后的起点。
    return masked.Addr(), masked.Bits(), nil
}

func main() {
    // PrefixFrom 不会替调用方清掉主机位，这里故意使用非规范地址。
    p := netip.PrefixFrom(netip.MustParseAddr("192.0.2.17"), 24)
    start, bits, err := networkStart(p)
    if err != nil {
        fmt.Println("处理失败:", err)
        return
    }
    fmt.Printf("起始地址=%s/%d\n", start, bits)
}

这段代码的重点是输入边界，而不是把 Prefix 当作字符串模板。示例的预期表示是 192.0.2.0/24；这里的输出是读者可复现的预期，不是本机执行记录。

按地址族计算网段的最后地址

取到规范化起始地址后，最后地址可以理解为：网络起始地址加上“主机位全部为 1”的数。IPv4 的主机位最多 32 位，IPv6 最多 128 位；Go 的 netip.Addr 提供 As4() 和 As16()，但直接在 uint64 上计算 IPv6 会丢失高位，因此更适合按字节做进位加法。

// 用地址族位宽计算最后地址，避免把IPv6压进uint64。
func lastAddress(p netip.Prefix) (netip.Addr, error) {
    if !p.IsValid() {
        return netip.Addr{}, fmt.Errorf("无效前缀")
    }
    masked := p.Masked()
    start := masked.Addr()
    hostBits := start.BitLen() - masked.Bits()
    if hostBits == 0 {
        // /32 或 /128 只有一个地址，起点就是终点。
        return start, nil
    }

    raw := start.As16()
    // 只把主机位设为1；前缀位保持Masked后的网络位。
    for bit := start.BitLen() - 1; bit >= masked.Bits(); bit-- {
        byteIndex := bit / 8
        bitIndex := 7 - (bit % 8)
        raw[byteIndex] |= 1 

这里用 As16() 统一承载两种地址族，再在 IPv4 分支通过最后 4 个字节还原 IPv4。循环只触碰主机位，因此即使输入地址携带主机位，前面 Masked() 已经确保网络位是规范状态。

主机位、单地址和地址族是排查重点

如果结果看起来“多了一个地址”或“范围不对”，先按下面顺序排查：

还要注意“地址范围”与“可用主机范围”不是一回事。CIDR 的起始地址和最后地址是数学边界；是否排除网络地址、广播地址，取决于上层协议和业务约定，不能在这个通用函数里擅自减一或加一。

用几个静态样例核对边界

下面的样例用于设计测试输入和检查预期，不代表本文在本机运行过代码：

在测试中，建议同时覆盖地址族边界和无效输入：零值前缀、超出位宽的前缀、IPv4-mapped IPv6、带 zone 的 IPv6 地址，以及前缀本身未规范化的情况。测试的目标是确认函数给出明确错误或稳定边界，而不是把任何输入都强行转换。

常见问题

Prefix.Addr() 是不是一定就是网络地址？

不是。它返回 Prefix 保存的 IP 地址；如果 Prefix 由 PrefixFrom 构造，主机位可能仍然存在。需要网络起点时调用 Masked().Addr()。

能不能直接用 Prefix.Overlaps 得到起止地址？

不能。Overlaps 只回答两个前缀是否有共同地址，起止地址仍要通过 Masked、地址位宽和主机位计算得到。

IPv4 的广播地址应该从最后地址中减一吗？

通用 CIDR 范围不应默认排除任何边界。是否把网络地址或广播地址视为不可分配资源，应由具体协议或业务规则另行决定。

把 Go netip.Prefix 转成范围时，记住三点即可：先验证、再 Masked、最后按地址族位宽展开主机位。这样能让 IPv4 和 IPv6 使用同一套思路，同时保留无效输入和单地址前缀的边界语义。