Go netip.AddrFrom16 构造 IPv6 地址的字节布局方案

需要把协议字段、二进制配置或固定长度缓冲区还原成 IPv6 地址时，netip.AddrFrom16 的输入契约很明确：传入一个 [16]byte，16 个字节按地址从高位到低位排列。它不会做字符串解析，也不会把 IPv4 映射地址自动变回 IPv4。

官方文档：https://pkg.go.dev/net/netip#AddrFrom16

一、先把固定数组和字节切片分开

AddrFrom16 接收的是 [16]byte，这意味着调用点已经承诺输入长度。比如协议头已经切出了完整的 IPv6 字段，就可以直接把 16 个字节交给它；如果原始数据还是 []byte，先转换数组也会让长度契约变得显式。

如果长度只有在运行时才知道，不要为了调用固定数组 API 手写一堆下标判断，改用 AddrFromSlice。它的返回值同时告诉你地址值和输入是否符合 4 或 16 字节规则。

二、按 16 字节顺序构造 IPv6

IPv6 地址由 128 位组成，传入数组的第 0 个元素对应最前面的 8 位。下面的示例用两个 64 位片段拼出一个地址，再通过 String 检查结果。示例中的移位只是为了展示字节落点，实际从网络报文读取时应先确认协议定义的字节顺序。

package main

import (
	"fmt"
	"net/netip"
)

func main() {
	// 每两个十六进制字节组成一个 IPv6 分组，数组顺序就是网络顺序。
	bytes := [16]byte{
		0x20, 0x01, 0x0d, 0xb8, 0x00, 0x01, 0x00, 0x02,
		0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x09,
	}
	addr := netip.AddrFrom16(bytes)
	// Is6 用来确认构造结果仍是 IPv6，String 负责规范化展示。
	fmt.Printf("%s is6=%t bits=%d\n", addr, addr.Is6(), addr.BitLen())
}

这里的结果应是 2001:db8:1:2::9，同时 Is6() 为 true、BitLen() 为 128。Addr 是小型、不可变且可比较的值类型，适合放入 map 或作为结构体字段。

三、不要误判 IPv4 映射 IPv6

有些系统会用 ::ffff:a.b.c.d 表示映射到 IPv4 的地址。它的底层仍然是 16 字节，因此调用 AddrFrom16 后，Is6() 仍为真。只有业务明确需要 IPv4 语义时，才调用 Unmap()。

// 说明 IPv4-mapped IPv6 在 AddrFrom16 和 Unmap 前后的语义差异。
mapped := [16]byte{
	0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
	0x00, 0x00, 0xff, 0xff, 192, 0, 2, 10,
}
addr := netip.AddrFrom16(mapped)
fmt.Println(addr, addr.Is6())       // ::ffff:192.0.2.10 true
fmt.Println(addr.Unmap(), addr.Unmap().Is4()) // 192.0.2.10 true

不要仅凭文本里出现 IPv4 四段数字就改变地址类型；判断依据应该是协议字段的语义，以及调用方是否需要把映射地址归一化。

四、用输入边界表完成接入验收

接入时最容易遗漏的是切片来源：如果它来自不可信报文，先检查 ok 再写入路由表或访问控制结构；如果它来自已经校验过的固定字段，AddrFrom16 更直接。这样既避免越界，也避免把 IPv4 映射 IPv6 的类型判断交给字符串处理。

相关问题

AddrFrom16 会自动识别 IPv4 吗？

不会。它按 16 字节构造 IPv6 地址；IPv4 映射形式仍保持 IPv6 语义，需要显式调用 Unmap。

为什么不用 net.ParseIP？

当输入已经是二进制字节时，netip.AddrFrom16 不需要先转成字符串，输入契约更清楚；只有文本地址才适合走解析 API。

16 字节切片应该怎么传入？

如果长度运行时确定，优先使用 AddrFromSlice；只有在上游已经保证长度时，才转换成 [16]byte 后调用 AddrFrom16。