Go netip.ParseAddr 遇到带区域标识的 IPv6：地址解析与 zone 的取舍

处理 IPv6 地址时，最容易混淆的是“地址本身”和“网卡区域”不是一回事。Go 的 netip.ParseAddr 适合解析一个 IP 地址值；如果输入来自链路本地地址，带有 %eth0 的 zone，还要先确认字符串格式和后续 API 是否需要这段区域信息。

netip.ParseAddr 解析出的 netip.Addr 可以保留 IPv6 zone；但 zone 只对带区域的 IPv6 地址有意义，普通全球单播 IPv6 不应人为拼接网卡名。需要端口时，再使用 netip.ParseAddrPort 处理方括号与端口。

为什么带 %eth0 的 IPv6 不能按普通字符串处理

链路本地 IPv6 常写成 fe80::1%eth0。前半段是 IPv6 地址，百分号后的 eth0 是区域标识，用来告诉系统应该从哪块接口寻找这条链路。这个信息不是 IPv6 数值的一部分，所以比较地址、打印地址和创建带端口的端点时，必须区分“地址值”和“展示文本”。

下面的最小配方先解析，再单独读取 zone。代码里的 ParseAddr、Addr.Zone 和 Is6 是同一条验证链上的三个节点。

package main

import (
    "fmt"
    "net/netip"
)

func main() {
    addr, err := netip.ParseAddr("fe80::1%eth0")
    if err != nil {
        panic(err)
    }
    fmt.Println(addr.Is6(), addr.Zone(), addr.String())
}

可见结果应表明这是 IPv6，Zone() 返回 eth0，而 String() 仍能生成带区域标识的地址文本。若把 %eth0 在进入解析前截掉，程序虽然可能继续运行，却已经丢掉了链路选择依据。

ParseAddr 和 ParseAddrPort 应该怎么分工

只有地址时用 ParseAddr；配置或连接目标同时带端口时，用 ParseAddrPort。IPv6 的端口写法必须把地址放在方括号中，否则冒号数量无法和端口边界区分。

addr, err := netip.ParseAddr("fe80::1%eth0")
if err != nil {
    return err
}

endpoint, err := netip.ParseAddrPort("[fe80::1%eth0]:8080")
if err != nil {
    return err
}
fmt.Println(addr.Zone(), endpoint.Port())

这里不要把 addr.String() + ":8080" 当成通用拼接方案：对 IPv6 来说，正确的端点文本需要方括号。使用 AddrPort 还能让端口保持数值语义，避免后续再手动切字符串。

日志、比较和连接参数里的三个常见坑

把 zone 当成可有可无的装饰

对 fe80::1%eth0 这类链路本地地址，删除 zone 可能让地址从“可定位到接口”变成“无法选择接口”。记录日志时可以同时输出 addr.String() 与 addr.Zone()，排障时更容易看出输入是否被清洗过。

普通 IPv6 也强行拼接网卡名

2001:db8::1 这类地址通常没有 zone。先判断 Zone() != "" 再决定是否展示或传递区域，避免把不属于地址的接口信息传播到配置文件。

用字符串切割代替结构化 API

直接按冒号切分 IPv6 会破坏地址本身；直接按百分号切分又容易把输入校验、转义和空 zone 混在一起。让 netip 负责解析，把业务校验放在解析成功之后，边界更清楚。

一段可复查的完整判断代码

func describe(raw string) (string, error) {
    addr, err := netip.ParseAddr(raw)
    if err != nil {
        return "", err
    }
    if !addr.Is6() {
        return "IPv4: " + addr.String(), nil
    }
    if zone := addr.Zone(); zone != "" {
        return "IPv6 zone=" + zone + " addr=" + addr.String(), nil
    }
    return "IPv6 without zone: " + addr.String(), nil
}

核对这段代码时看三条路径：解析失败直接返回错误；IPv4 不读取 zone；IPv6 再按 Zone() 是否为空分支。这样既不会把 zone 误加到普通 IPv6，也不会在链路本地地址上静默丢失接口信息。

相关问题

zone 会改变 IPv6 的数值地址吗？

不会。zone 是链路范围信息，不改变 IPv6 地址的数值部分，但会影响系统选择接口。

没有端口时能用 ParseAddrPort 吗？

不适合。没有端口就用 ParseAddr，让 API 语义和输入格式保持一致。

为什么 IPv6 端点要写方括号？

因为 IPv6 地址本身包含多个冒号，方括号能明确地址结束位置，后面的冒号才表示端口分隔符。

小结

这类问题的关键不是记住一个特殊字符串，而是保留 netip.Addr 的结构化语义：先解析地址，再按需读取 zone；涉及端口时直接解析成 AddrPort。输入、日志和连接参数都沿着这条边界处理，IPv6 的链路范围信息就不会在字符串转换中悄悄丢失。