Go netip.PrefixFrom 怎么构造并规范化网段

Go 的 net/netip 用 netip.PrefixFrom 可以直接把一个 Addr 和前缀位数拼成 CIDR 前缀。关键要记住：它只负责构造，不会自动把地址的 host bits 清零；如果要得到规范化网段，还要继续调用 Masked()。例如地址是 192.0.2.37、位数是 24，原始前缀仍保留 192.0.2.37/24，规范化结果才是 192.0.2.0/24。

先把 Addr 和前缀位数交给 PrefixFrom

PrefixFrom 的签名是 netip.PrefixFrom(ip netip.Addr, bits int) netip.Prefix。因此输入阶段先解析地址，再明确位数来自哪条业务规则。对于固定配置可以使用 MustParseAddr，但外部输入应保留错误返回，避免把错误地址变成 panic。

package main

import (
    "fmt"
    "net/netip"
)

func main() {
    ip, err := netip.ParseAddr("192.0.2.37") // 外部输入先解析并保留错误
    if err != nil {
        panic(err) // 示例直接终止；服务代码应把错误返回给调用方
    }

    raw := netip.PrefixFrom(ip, 24) // 只组合地址与 24 位前缀长度
    canonical := raw.Masked()      // 显式清掉 host bits，得到规范网络号

    fmt.Println(raw.String())       // 192.0.2.37/24
    fmt.Println(canonical.String()) // 192.0.2.0/24
}

这里的两个值用途不同：raw 能保留调用方提供的具体地址，canonical 才适合表示可合并、可比较的网络范围。不要看到 Prefix 类型就默认它已经是网络号。

先检查 Bits 和 IsValid，再使用结果

IPv4 的地址位数是 32，IPv6 是 128，合法前缀长度包括 0 和地址位数本身。PrefixFrom 不返回 error；当 bits 小于 0 或大于 ip.BitLen() 时，返回前缀的 Bits() 会是 -1，IsValid() 也会是 false。这也是它和 Addr.Prefix 在调用契约上的重要区别。

func makePrefix(ip netip.Addr, bits int) (netip.Prefix, error) {
    prefix := netip.PrefixFrom(ip, bits) // PrefixFrom 用 -1 表达非法位数
    if !prefix.IsValid() {
        return netip.Prefix{}, fmt.Errorf("前缀长度 %d 不适用于 %s", bits, ip) // 不让无效值流入路由表
    }
    return prefix, nil
}

需要规范化网段时调用 Masked

PrefixFrom 的核心行为是“不屏蔽 host bits”。这对记录某个地址落在哪个前缀里很有用，但如果要生成网络配置、做去重或作为缓存键，就应该调用 Masked()。它会保留高位前缀，把剩余位清零；无效或零值前缀则返回零值前缀，后续仍要用 IsValid() 检查。

判断包含关系时，建议保存规范化前缀并直接调用 Contains，不要自行把地址转成整数后写一套掩码逻辑：

network := netip.PrefixFrom(netip.MustParseAddr("10.20.30.44"), 24).Masked() // 固定测试数据可使用 MustParseAddr
probe := netip.MustParseAddr("10.20.30.99")
if network.Contains(probe) { // 让 netip 按地址族和前缀规则判断
    fmt.Println("地址位于网段内")
}

IPv4 前缀不能包含 IPv6 地址，IPv4-mapped IPv6 也不会自动当成 IPv4 匹配；跨地址族输入应在业务边界先统一。若只是要保存调用方原始 host bits，则保留 raw，不要用 Masked 覆盖它。

构造、规范化和序列化的检查清单

1. 地址来自字符串或字节时，先用 ParseAddr 或 AddrFromSlice 检查有效性。
2. 位数来自配置或请求时，按 ip.BitLen() 限制范围，并检查 Bits() 或 IsValid()。
3. 表示网络范围时调用 Masked()，再用 String() 写入日志、配置或缓存键。
4. 做成员判断时使用 Contains，同时确认探测地址与前缀属于同一地址族。

相关问题

PrefixFrom 和 Addr.Prefix 该选哪个？

如果你希望构造时就得到按前缀屏蔽的结果，用 Addr.Prefix 并处理它的 error；如果需要保留 host bits，或已经掌握位数合法性，可用 PrefixFrom，再按需要调用 Masked。

为什么 PrefixFrom 没有 error 返回值？

它把非法长度编码到返回的 Prefix 状态中，调用方通过 Bits() == -1 或 IsValid() 判断。对外部配置不要跳过这一步。

Masked 会改变原来的 Prefix 吗？

不会。Prefix 是值类型，Masked 返回新的规范化值；你可以同时保留原始前缀和网络号前缀。

小结：Go 使用 netip.PrefixFrom 构造网段时，先确认 Addr 与位数有效，再根据语义决定是否调用 Masked()。构造和规范化是两个动作，分开处理才能避免 CIDR 字符串、包含判断和缓存键出现不一致。