Go netip.Addr 的 zero 值怎样判断

判断 netip.Addr 是否为无效零值，通常使用 !addr.IsValid()；需要直接与零值比较时，也可以使用 addr == (netip.Addr{})。Addr 是可比较的值类型。不要用 IsUnspecified 代替这个判断：0.0.0.0 和 :: 是有效的未指定地址，均不等于 Addr 的零值。

官方地址：https://pkg.go.dev/net/netip

在配置读取场景中，最容易混淆的是“没有地址”“地址格式错误”和“用户明确填了未指定地址”。它们可能需要完全不同的处理方式，不能都转换成看起来由零组成的 IP。

先用 IsValid 识别零值

声明一个未赋值的 Addr 变量，就得到该类型的零值，它不代表 IPv4 或 IPv6 地址。IsValid 用于判断是否为有效的地址值；对零值返回 false。它适合作为地址处理接口的类型层面判断。

Addr 不是指针，不用拿它与 nil 比较。直接与空结构形式的零值比较也是合法的，不过在大多数业务条件中，IsValid 更容易表达“这里必须已有有效地址”的意图。

区分 0.0.0.0 和 IPv6 未指定地址

IPv4 的 0.0.0.0 与 IPv6 的 :: 都是有明确地址族的有效值。它们表达未指定地址，不是“Go 变量尚未初始化”。读取配置后是否允许这种值，是业务规则，应在地址有效性之后单独处理。

这张表说明的是 API 语义，不是当前机器的网络配置或连通性。IsValid 不证明地址存在于本机，也不证明目标可达；IsUnspecified 也不应作为连接目的地是否适用的唯一检查。

解析时保留错误信息

外部文本应通过 ParseAddr 解析，并检查 error。不要忽略错误后只看返回值是否有效，否则日志里只剩“无效”，却丢失了输入为何被拒绝的信息。MustParseAddr 则适合代码中确定正确的常量，不能直接用于不可信的配置输入。

下面是完整示例。它自行约定空字符串表示未提供，其他输入解析失败则返回错误。这个空字符串规则属于应用接口约定，并不是 ParseAddr 自动赋予空输入的含义。

package main

import (
    "fmt"
    "net/netip"
)

func parseOptional(raw string) (netip.Addr, bool, error) {
    // 这里明确约定空字符串表示配置未提供，不能把非法文本也吞掉。
    if raw == "" {
        return netip.Addr{}, false, nil
    }
    addr, err := netip.ParseAddr(raw)
    if err != nil {
        return netip.Addr{}, false, fmt.Errorf("地址 %q 无法解析: %w", raw, err)
    }
    return addr, true, nil
}

func main() {
    var zero netip.Addr
    fmt.Println("zero valid:", zero.IsValid())
    fmt.Println("zero equals:", zero == (netip.Addr{}))
    inputs := []string{"", "0.0.0.0", "::", "192.0.2.27", "not-an-ip"}
    for _, raw := range inputs {
        addr, supplied, err := parseOptional(raw)
        if err != nil {
            // 解析错误与未提供是两类状态，分别向上层表达。
            fmt.Println(err)
            continue
        }
        if !supplied {
            fmt.Println("未提供地址")
            continue
        }
        fmt.Printf("%s valid=%t unspecified=%t\n",
            addr, addr.IsValid(), addr.IsUnspecified())
    }
}

按代码逻辑，零值的有效性为 false；两个未指定地址的有效性与未指定判断都为 true；普通示例地址有效但不是未指定；非法文本走错误分支。本文没有在本地运行示例，插图也不作为运行输出。

在配置中表达缺失与无效

示例同时返回地址、是否提供和错误，让调用方保留三类状态：用户没填，用户填错，用户填入合法地址。若配置系统还允许显式清空或继承上一级设置，应继续在配置模型中表达，而不是让某个 IP 值承担全部哨兵含义。

应用可能把零值作为内部“未设置”标志，但必须在入口约定清楚。否则解析失败与未设置都落到零值，后续可能错误地启用默认值，把一个原本应被拒绝的配置静默接受。

若某个用途不允许未指定地址，可在解析成功后再拒绝 IsUnspecified 为 true 的值。这一步是业务约束，与 IsValid 的类型有效性保持分开，错误提示也更容易解释。

读取与存储时使用类型判断

内存中保存 Addr 时，使用类型方法判断，不建议把 String 的显示文本当作状态协议。给日志输出友好字符串和给业务判断状态是不同任务；后者应保留 IsValid、显式是否提供或解析错误。

Addr 本身适合按值传递和比较。写入配置、缓存或其他存储边界时，应明确空值和错误的编码规则。清理某个可选地址字段时，可以把字段恢复零值并同步更新是否提供标志，但不要把它改为 0.0.0.0 来表示删除，除非业务接口确实如此定义。

全零的四字节数组会生成无效 Addr 吗？

用 AddrFrom4 构造全零 IPv4 字节会得到有效的 0.0.0.0。地址内容全零与类型零值是不同概念。

ParseAddr 能直接接收带端口的地址吗？

地址与地址加端口是不同输入类型。需要解析 IP 和端口组合时，应选择 ParseAddrPort，并处理其错误。

IsValid 为 true 就能直接连接吗？

不能据此断言连通性，也不能替代目的地址范围、端口和业务限制。它只回答是否为有效地址值。

参考：Addr.IsValid、Addr.IsUnspecified、ParseAddr。