Go netip.Addr.IsLinkLocalUnicast 怎样判断链路本地地址

在 Go 里判断一个 IP 是否属于链路本地单播，不需要手写 CIDR 范围比较。把文本交给 netip.ParseAddr，确认没有解析错误后，直接调用 Addr.IsLinkLocalUnicast() 即可。这个方法同时覆盖 IPv4 和 IPv6；判断结果只表示地址类别，不表示本机一定配置了对应网卡，也不表示地址已经可达。

最小写法是：先解析 netip.ParseAddr(text)，再读取 addr.IsLinkLocalUnicast()。典型的 IPv4 链路本地范围是 169.254.0.0/16，IPv6 则通常落在 fe80::/10。

先给结论：解析后调用 IsLinkLocalUnicast

判断函数应该把“输入是否是合法 IP”和“合法 IP 属于哪一类”分成两个结果处理。这样，拼写错误的文本不会被当成“不是链路本地地址”，而是明确返回解析错误。

package main

import (
    "fmt"
    "net/netip"
)

// isLinkLocal 只负责解析文本并完成地址分类，不负责探测本机网卡。
func isLinkLocal(text string) (bool, error) {
    // ParseAddr 支持 IPv4、IPv6，以及带 zone 的 IPv6 文本。
    addr, err := netip.ParseAddr(text)
    if err != nil {
        // 解析失败必须单独返回，避免把非法输入误报成普通地址。
        return false, err
    }

    // 方法内部按 Addr 的地址类别判断，调用方不需要手写掩码。
    return addr.IsLinkLocalUnicast(), nil
}

func main() {
    ok, err := isLinkLocal("169.254.12.7")
    fmt.Println(ok, err)
}

这里的 bool 只回答“是不是”，error 回答“输入能不能先被解析”。在配置文件、HTTP 参数或日志字段中读取地址时，建议保留这两个结果，不要只用一个布尔值继续往下走。

把文本输入与地址分类分开

netip.ParseAddr 返回 (netip.Addr, error)。常见输入可以先放进一个表格驱动的示例里，观察每一类输入应该怎样处理：

package main

import (
    "fmt"
    "net/netip"
)

func main() {
    samples := []string{
        "169.254.12.7",       // IPv4 链路本地单播。
        "fe80::1",            // IPv6 链路本地单播。
        "fe80::1%en0",        // 带接口 zone 的 IPv6 地址。
        "192.168.1.10",       // 私有地址，不是链路本地地址。
        "fe80::",             // 仍是 IPv6 链路本地地址范围内的地址。
        "not-an-ip",          // 非法文本，解析阶段直接报错。
    }

    for _, text := range samples {
        // 先判断 err，再读取分类结果，避免使用无效 Addr。
        addr, err := netip.ParseAddr(text)
        if err != nil {
            fmt.Printf("%-16s parse error: %v\n", text, err)
            continue
        }

        // 这里输出的是地址类别，不是网络连通性探测结果。
        fmt.Printf("%-16s link-local=%v\n", text, addr.IsLinkLocalUnicast())
    }
}

带 %en0 的 IPv6 文本包含 scoped addressing zone。解析成功后，zone 仍属于地址信息的一部分；如果后续代码需要单独读取接口标识，可以使用 addr.Zone()。但这不改变 IsLinkLocalUnicast 的使用方式。

同时覆盖 IPv4、IPv6 和 zone

这个方法的价值在于调用方不需要为两种 IP 版本维护两套范围判断。IPv4 的链路本地单播通常是 169.254.0.0/16，IPv6 的链路本地单播通常是 fe80::/10；将文本解析为 netip.Addr 后，统一调用同一个方法即可。

要注意，IPv6 的链路本地地址经常和接口 zone 一起出现，例如 fe80::1%en0。zone 用来标识作用域，但方法判断的主体仍是地址类别。不要因为字符串里出现了接口名，就改用字符串前缀比较；结构化的 Addr 更适合继续传递、比较和做 map key。

package main

import (
    "fmt"
    "net/netip"
)

func describe(text string) {
    // 解析阶段处理格式，分类阶段处理语义，两者不要混在字符串判断里。
    addr, err := netip.ParseAddr(text)
    if err != nil {
        fmt.Printf("%s: invalid address\n", text)
        return
    }

    // Zone 只对带作用域的 IPv6 有值，IPv4 通常返回空字符串。
    fmt.Printf("%s: local=%v, zone=%q\n", text, addr.IsLinkLocalUnicast(), addr.Zone())
}

func main() {
    describe("169.254.12.7")
    describe("fe80::1%en0")
}

区分链路本地单播与相近类别

实际排查时最容易混淆的是“私有地址”“回环地址”和“链路本地组播”。它们都可能出现在本地网络代码里，但用途不同，不能只看到内网地址或 fe80 前缀就统一处理。

如果业务还要判断私有、回环或组播，应分别调用对应的 IsPrivate、IsLoopback 或 IsMulticast。不要把多个分类方法压缩成一个“本地地址”布尔值，否则后续的监听、路由或日志策略很难解释。

明确 zero Addr 与网络可达性的边界

netip.Addr{} 是 zero Addr，不是合法的 0.0.0.0 或 ::。如果地址来自可选配置或结构体零值，先考虑 addr.IsValid()，再进入业务分类。一个无效地址即使调用分类方法得到 false，也不应该被当成“确认过的普通地址”。

同样，IsLinkLocalUnicast 只做静态地址分类。它不会检查本机是否真的有 en0、eth0 等接口，也不会判断路由表、邻居发现或对端是否在线。若业务需要建立连接，应把地址分类、接口选择和连接错误分成独立的处理层。

小结：用结构化地址替代字符串前缀判断

处理链路本地地址可以固定成四个动作：读取文本、调用 netip.ParseAddr、先处理 error、最后调用 IsLinkLocalUnicast。IPv4、IPv6 和带 zone 的 IPv6 共用同一套判断入口；私有、回环和组播则使用各自的分类方法。这样代码表达的是地址语义，而不是依赖字符串前缀的猜测。

常见问题

IsLinkLocalUnicast 能判断本机网卡是否存在吗？

不能。它只判断 netip.Addr 的地址类别；接口是否存在需要另外读取系统网络接口或由连接过程返回结果。

带 %en0 的 IPv6 地址还能直接判断吗？

可以。先用 netip.ParseAddr 解析，成功后直接调用方法；需要接口作用域时再读取 addr.Zone()。

私有地址为什么不是链路本地地址？

私有地址和链路本地地址是不同的地址类别。前者通常用于组织内部网络，后者表示特定链路范围内的本地通信，因此应使用不同的分类方法和业务策略。