Go net.ParseIP 判断 IPv4 时为什么得到十六字节结果

很多 Go 程序第一次打印 net.ParseIP("192.0.2.1") 时会发现：明明输入的是 IPv4，返回值的长度却是 16。这个结果是设计如此，不是解析失败。net.ParseIP 会把 IPv4 放进 IPv4-mapped IPv6 表示，因此判断 IPv4 时应使用 ip.To4() != nil；只有在确实需要四字节数据时，才取 To4() 的结果。

记住三句话：ParseIP 负责把文本解析成 net.IP，IPv4 返回 16 字节的 mapped 形式；To4() 负责把 IPv4 规范化成 4 字节；解析失败先判断 nil，不要直接切片。

先看清 16 字节到底表示什么

在标准库中，net.IP 本质上是字节切片。ParseIP 对 IPv4、IPv6 和 IPv4-mapped IPv6 统一返回 16 字节结果。IPv4 的四个字节位于最后四个位置，前面是 IPv4-mapped IPv6 前缀，所以 String() 仍然打印成熟悉的点分十进制。

因此，len(ip) == 16 只能说明当前切片采用了 16 字节表示，不能说明它一定是原生 IPv6。真正要判断它能否按 IPv4 使用，应调用 To4()。

用 To4 做地址族判断和四字节转换

下面的例子同时观察长度、To4 和无效输入。代码中的输出是示例结果，用来说明判断逻辑；图片也是结构示意，不是本机运行截图。

package main

import (
	"fmt"
	"net"
)

func inspectIP(text string) {
	// 先判断 nil，避免把非法文本当成有效地址继续处理。
	ip := net.ParseIP(text)
	if ip == nil {
		fmt.Printf("%s: invalid\\n", text)
		return
	}

	// To4 非 nil 才代表它可以按 IPv4 的四字节形式使用。
	ipv4 := ip.To4()
	fmt.Printf("%s: raw=%d bytes, ipv4=%v\\n", text, len(ip), ipv4 != nil)
	if ipv4 != nil {
		// 这里的切片适合交给需要 IPv4len 数据的下游接口。
		fmt.Printf("four=%d bytes, value=%s\\n", len(ipv4), ipv4.String())
	}
}

func main() {
	inspectIP("192.0.2.1")
	inspectIP("2001:db8::1")
	inspectIP("192.0.2")
}

192.0.2.1: raw=16 bytes, ipv4=true
four=4 bytes, value=192.0.2.1
2001:db8::1: raw=16 bytes, ipv4=false
192.0.2: invalid

比较、序列化和网络调用要分清边界

如果只是判断两个地址是否相同，net.IP.Equal 会把 IPv4 和它对应的 mapped 形式视为相等。若要判断地址族，使用 To4() != nil；若接口要求固定 16 字节，可使用 To16()，但它不是“判断 IPv4”的替代品。

不要把 ip[12:] 当成通用转换规则：它只适用于确定是 mapped IPv6 的情况，而且绕过了标准库对长度和前缀的判断。跨存储边界时，建议保存地址文本或明确的 4/16 字节字段，并在入口处完成一次规范化。

遇到 CIDR 或新代码时怎么选

带掩码的输入不要先用 ParseIP 再手动拆分，应使用 net.ParseCIDR，让地址和掩码一起解析。新项目如果不需要兼容旧的 net.IP 接口，可以评估 net/netip.ParseAddr：它提供更明确的地址值语义，并能通过 Is4、As4 或 AsSlice 选择输出形式。

最后检查三处最容易出错的地方：是否在 nil 检查前调用了方法；是否把 len(ip) 当成 IPv4/IPv6 判据；是否因为数据库或协议字段需要 4 字节，就错误地把所有 16 字节结果截断。

相关问题

为什么 net.IPv4 本身也可能是 16 字节？

net.IPv4 返回的是 IPv4 的 16 字节表示，和 ParseIP 的选择保持一致；需要四字节时同样调用 To4()。

To4() 返回 nil 应该怎么办？

把它当成“不是 IPv4”的明确结果：如果业务只接受 IPv4，就返回输入错误；如果同时支持 IPv6，则保留原值并走 IPv6 分支。

参考资料

• Go net.ParseIP 文档：返回表示与非法输入约定。
• Go net.IP.To4 文档：四字节转换规则。
• Go 标准库 net/ip.go：ParseIP、To4 和 Equal 的实现。