netip拆分IP地址与端口

配置文件里拿到 192.0.2.10:443 时，很多人第一反应是手动找冒号。这个办法遇到 IPv6 就会失效，因为 IPv6 地址本身就包含多个冒号。Go 的正确做法是让 netip.ParseAddrPort 负责完整解析：它返回一个类型化的 netip.AddrPort，再用 Addr() 和 Port() 取出 IP 与端口。

netip.ParseAddrPort 解决的是结构化地址输入

ParseAddrPort 的返回值不是两个零散字符串，而是 AddrPort。这让后续代码可以直接比较地址、读取端口，或把它继续传给接受 netip.AddrPort 的网络 API。它不做 DNS 解析，因此 api.example.com:443 不属于它的输入范围。

package main

import (
    "fmt"
    "net/netip"
)

func main() {
    // 统一处理 IPv4 和带方括号的 IPv6 地址，避免手动切分冒号。
    inputs := []string{"192.0.2.10:443", "[2001:db8::10]:8443"}
    for _, text := range inputs {
        endpoint, err := netip.ParseAddrPort(text)
        if err != nil {
            // 生产代码应把原始输入和错误一起记录，便于定位配置问题。
            fmt.Printf("跳过 %q：%v\n", text, err)
            continue
        }
        fmt.Printf("addr=%s port=%d normalized=%s\n", endpoint.Addr(), endpoint.Port(), endpoint)
    }
}

读取结果时，Addr() 返回 netip.Addr，Port() 返回 uint16。直接打印 endpoint 会得到规范化后的地址端点表示，适合做日志或键值。

IPv6 的方括号不是可选装饰

对 IPv4，192.0.2.10:443 的边界很明确；对 IPv6，方括号把“地址里的冒号”和“端口分隔符”区分开。[2001:db8::10]:443 可以解析，而 2001:db8::10:443 会被判定为缺少 IPv6 的方括号。

只拆字符串时，换用 net.SplitHostPort

如果输入来自监听配置，主机部分可能是域名、通配地址或带 zone 的文本，此时目标不是立刻得到 AddrPort，而是先拆成 host 和 port 两个字符串。net.SplitHostPort 更合适：

package main

import (
    "fmt"
    "net"
    "strconv"
)

func splitEndpoint(text string) error {
    // 先按网络端点语法拆分，保留域名或 zone 的原始文字。
    host, portText, err := net.SplitHostPort(text)
    if err != nil {
        return fmt.Errorf("拆分 %q：%w", text, err)
    }
    // 端口仍要单独校验，避免把任意文字当成可连接端口。
    port, err := strconv.ParseUint(portText, 10, 16)
    if err != nil {
        return fmt.Errorf("端口 %q 无效：%w", portText, err)
    }
    fmt.Printf("host=%s port=%d\n", host, port)
    return nil
}

两者的选择可以记成一句话：要“IP 地址+端口”的值对象，用 netip.ParseAddrPort；要“主机文字+端口文字”的语法拆分，用 net.SplitHostPort。不要把字符串的 Split 当作通用网络地址解析器。

常见问题

ParseAddrPort 能解析域名吗？

不能。它要求地址与端口都是数字；域名应先用 net.SplitHostPort 拆出，再通过解析器处理。

端口可以写成 08080 吗？

可以按十进制数字解析，但仍不能超过 65535。若配置格式还要限制前导零，应在业务层增加规则。

为什么 IPv6 必须加方括号？

因为 IPv6 地址内部已经包含冒号。方括号明确了地址的完整范围，最后一个冒号才表示端口分隔符。

实际接入时，先确定输入契约，再选择 API：类型化端点走 ParseAddrPort，保留主机文本走 SplitHostPort。这样既不会误切 IPv6，也能把错误边界留在入口处处理。