Go netip.Addr.IsUnspecified 怎样判断未指定 IP 地址

netip.Addr.IsUnspecified() 用于判断 IPv4 的 0.0.0.0 或 IPv6 的 ::。两者都是有效Addr；var a netip.Addr 得到的零值则不是未指定地址，它的IsValid和IsUnspecified都为false。接收字符串时先处理ParseAddr错误，再调用分类方法。

官方地址：https://go.dev/

整理一份地址配置时，我更愿意保留输入的“有没有提供”和地址本身两个维度。否则空字符串、初始化失败与合法的全零地址容易在一列状态里被混淆。下面沿着输入、解析、保存和查询组织一个小例子，只讨论地址值分类，不扩展到地址分配、监听行为或访问授权。

让原始输入保留自己的含义

字符串来源可能是配置字段、命令行参数或表单。应先确定空白意味着什么：字段缺失、显式空字符串，还是输入错误。本文不自动TrimSpace，也不把空输入替换成0.0.0.0；这样解析规则和原始输入之间没有隐含改写。

若上游允许空白，应在接口契约中明确如何规范化，并同时保留原始值供诊断。不要用“字符串里只有0”判断未指定IP：IPv6可以有多种等价的文本写法。

先解析再判断地址分类

ParseAddr把文本变成Addr值，IsUnspecified判断地址值所属的类别。下面完整程序把解析错误单独返回，成功后再给出unspecified或other-valid标签。这些标签是本文程序定义的业务分类。

package main

import (
    "fmt"
    "net/netip"
)

// classify 将解析失败与有效地址的分类结果分开返回。
func classify(raw string) (string, error) {
    addr, err := netip.ParseAddr(raw)
    if err != nil {
        return "", fmt.Errorf("IP解析失败: %w", err)
    }
    if addr.IsUnspecified() {
        return "unspecified", nil
    }
    return "other-valid", nil
}

func main() {
    inputs := []string{"0.0.0.0", "::", "0:0:0:0:0:0:0:0", "192.0.2.18", "", "not-an-ip"}
    for _, raw := range inputs {
        kind, err := classify(raw)
        if err != nil {
            fmt.Printf("input=%q error=%v\n", raw, err)
            continue // 保留错误，不把失败当成other-valid。
        }
        fmt.Printf("input=%q kind=%s\n", raw, kind)
    }
    var zero netip.Addr
    // 零值是未初始化状态，不是IPv6的全零地址。
    fmt.Printf("zero valid=%t unspecified=%t\n", zero.IsValid(), zero.IsUnspecified())
}

将源码保存为main.go后，可用以下命令自行运行：

# 运行独立的地址分类示例，不会发起网络连接。
go run main.go

预期前三个输入都归为unspecified，192.0.2.18归为other-valid；空串和not-an-ip产生解析错误。最后一行的两个布尔预期都为false。这些是依据代码与接口语义给出的预期，不是本机实测日志。

把零值Addr与未指定地址分开存储

零值Addr表达未初始化，而不是某个地址族的全零地址。若从数据结构读到零值，应检查它代表缺失、错误后未赋值，还是其他应用状态；仅凭IsUnspecified=false不能得出“这是一个普通有效IP”。

对于配置记录，可用Present描述字段是否出现，用Addr保存已解析的值。解析失败时不要将记录作为成功配置写入；若确需留存失败输入，应另存错误信息，不能只放一个零值后丢掉原因。

查询时组合IsValid与IsUnspecified

当函数拿到的已经是Addr，而不是ParseAddr成功路径里的局部值，先用IsValid处理零值会更明确。下面片段放在已导入net/netip的包内：

type AddressEntry struct {
    Raw     string
    Present bool
    Addr    netip.Addr
}

// classifyEntry 不把缺失字段自动解释成任何一个有效IP。
func classifyEntry(e AddressEntry) string {
    if !e.Present {
        return "missing"
    }
    if !e.Addr.IsValid() {
        return "invalid"
    }
    if e.Addr.IsUnspecified() {
        return "unspecified"
    }
    return "other-valid"
}

如果上游已经保证Addr有效，分类代码可以直接调用IsUnspecified；这是调用契约带来的简化，不代表IsUnspecified能够替代有效性判断。保留这项前提，后续维护者才能理解省略检查的原因。

异常输入与临时结果怎样处理

不要忽略ParseAddr的错误，也不要对外部输入直接使用MustParseAddr来省略错误分支。示例使用ParseAddr后返回带上下文的错误，使调用方可以决定提示、拒绝保存或保留错误记录。

临时Addr是值，不需要Close。需要清理的是应用留存的诊断记录和原始输入，而不是Addr内部资源。若应用对原始配置有保留期限，应按自己的数据规则删除，不需要为本例新增后台清理任务。

IPv6完整写法0:0:0:0:0:0:0:0需要特殊判断吗？

不需要先替换成双冒号；解析为相同地址值后调用IsUnspecified即可。

IsUnspecified=false是否说明地址可以访问？

不能。它只回答是否属于未指定地址，不负责连接可达性、接口分配或访问控制。

可以直接把零值Addr当作::吗？

不能。若业务确实需要默认IPv6未指定值，应显式创建对应地址，并记录默认规则；不要悄悄改变缺失字段的语义。

我的处理顺序是先保留输入含义，解析失败就返回错误，成功后按地址方法分类。需要存储和再次查询时，再把字段存在性、Addr有效性与未指定类别分别记录。这能避免一个false值承载多种互不相同的状态。

官方资料：Addr.IsUnspecified；Addr.IsValid。