Go netip.Addr.Zone 怎样读取 IPv6 地址的接口标识

处理链路本地 IPv6 地址时，fe80::1%eth0 里的 %eth0 不是地址位，而是接口作用域。Go 可以用 netip.ParseAddr 解析整段文本，再用 Addr.Zone() 读取这个标识；需要做纯地址比较或前缀判断时，则先用 WithZone("") 得到无 zone 的新值。

先分清地址本体和接口作用域

IPv6 的链路本地地址可能在不同网卡上重复出现，因此仅写地址本体不足以说明要走哪块网卡。fe80::1%eth0 可以拆成两部分：fe80::1 是可参与地址运算的部分，eth0 是当前作用域的接口标识。这个标识属于地址的语义信息，但不属于 128 位地址本身。

工程里常见的分歧是：日志和网络发送需要保留完整文本，哈希、字节比较或前缀匹配又往往只关心地址本体。把两种用途混在一起，就容易出现日志看起来正确、匹配却失败的情况。

解析地址并读取 Zone

入口统一用 netip.ParseAddr，不要先按百分号手工切字符串。这样可以让标准库负责地址格式和作用域的解析，业务代码只处理错误、地址值和 zone。

package main

import (
    "fmt"
    "net/netip"
)

func main() {
    // %eth0 是接口作用域，不是 IPv6 地址位本身。
    addr, err := netip.ParseAddr("fe80::1%eth0")
    if err != nil {
        fmt.Println("解析地址失败：", err)
        return
    }

    // Zone 只读取作用域；没有作用域时结果是空字符串。
    fmt.Printf("完整地址=%s，zone=%q，IPv6=%v\n", addr, addr.Zone(), addr.Is6())
}

这里的 String() 会保留 zone，所以日志中的 addr 仍然是 fe80::1%eth0。如果输入是普通 IPv6 或 IPv4，Zone() 返回 ""，可以用空值判断是否需要走接口作用域分支。

WithZone 与前缀判断的边界

Addr 是值类型，WithZone 会生成一个新的地址。传入新的接口名可以替换作用域，传入空字符串可以清除作用域；对 IPv4 地址调用它不会凭空制造 IPv6 zone。

prefix := netip.MustParsePrefix("fe80::/64")

scoped := netip.MustParseAddr("fe80::1%eth0")
plain := scoped.WithZone("")
other := scoped.WithZone("eth1")

fmt.Println(scoped)                         // fe80::1%eth0
fmt.Println(plain, plain.Zone())            // fe80::1
fmt.Println(other, other.Zone())            // fe80::1%eth1
fmt.Println(prefix.Contains(scoped))        // false：仍带 zone
fmt.Println(prefix.Contains(plain))         // true：先去掉 zone

这段代码表达了一个重要边界：前缀代表的是地址空间，而接口作用域代表的是到达范围。做 Prefix.Contains、As16 或纯地址键计算前，先明确是否应该保留作用域；不要为了让判断通过而无条件丢弃 zone。

如果系统后续要发送链路本地流量，应该继续保留带 zone 的地址；如果只是把地址归入某个网段、生成稳定的地址本体键，则可以在明确语义后使用 plain。两种值都来自同一个输入，避免了重新拼接字符串造成的格式风险。

工程落地时的处理清单

建议在解析边界就保留 netip.Addr，不要把地址和 zone 拆成两个字符串长期流转。只有在进入“纯地址”算法前，才显式调用 WithZone("")，并在变量名或注释中说明这是有意去除作用域。

常见疑问

没有 zone 时 Zone 会返回什么

返回空字符串。普通 IPv6、IPv4 和零值地址都可以按这个结果做无作用域分支判断。

WithZone 会改变原来的 Addr 吗

不会。Addr 是值类型，调用后得到新的值；原地址仍保留原来的 zone。

As16 会把接口名一起转成字节吗

不会。它表达的是地址本体的 16 字节形式，接口作用域不在这组地址字节中。

为什么 Prefix.Contains 带 zone 的地址可能返回 false

前缀判断针对地址本体；带 zone 的 IPv6 地址需要先明确是否应该用 WithZone("") 清除作用域，再进行匹配。

归纳起来，Zone() 适合读取“这条 IPv6 地址要落在哪个作用域”，WithZone 适合在保留或清除这个语义之间建立明确边界。先解析成 netip.Addr，再按用途选择完整值或无 zone 值，代码会比手工拆分字符串更稳定。