Go netip.Addr.Is4 怎样判断地址是否为 IPv4

在 Go 的 net/netip 包里，判断一个 Addr 是否是原生 IPv4，直接调用 addr.Is4() 即可。它返回 true 的对象是 IPv4 地址；IPv4-mapped IPv6 虽然包着一个 IPv4 地址，但仍按 IPv6 地址处理，所以 Is4() 会返回 false。

官方资料：https://pkg.go.dev/net/netip#Addr.Is4

Is4 判断的对象到底是哪一种 IPv4

netip.Addr 是一个不可变、可比较的值类型。判断地址族时，应该使用它提供的语义方法，而不是拿 String() 的输出做字符串猜测。

最小写法如下：

package main

import (
	"fmt"
	"net/netip"
)

func main() {
	addresses := []string{
		"192.0.2.10",          // 原生 IPv4
		"::ffff:192.0.2.10",   // IPv4-mapped IPv6
		"2001:db8::10",        // 普通 IPv6
	}

	for _, text := range addresses {
		// ParseAddr 负责把文本解析成 Addr，解析失败时不要继续判断地址族。
		addr, err := netip.ParseAddr(text)
		if err != nil {
			fmt.Printf("%s: 解析失败: %v\\n", text, err)
			continue
		}

		// Is4 只回答“是不是原生 IPv4”，不会把映射 IPv6 当成 IPv4。
		fmt.Printf("%s: Is4=%v, Is4In6=%v, Is6=%v\\n",
			text, addr.Is4(), addr.Is4In6(), addr.Is6())
	}
}

这段代码的判断关系可以概括为：原生 IPv4 的 Is4() 为 true；映射地址的 Is4() 为 false、Is4In6() 为 true；普通 IPv6 的 Is6() 为 true。零值 Addr 也不会被当作有效 IPv4。

Is4、Is4In6、Is6 和 Unmap 怎么选

这几个方法解决的不是同一个问题。先确定你要判断地址族，还是要把映射形式归一化，再选择 API。

如果业务只允许原生 IPv4，使用 Is4()；如果要识别兼容层传来的映射形式，使用 Is4In6()；如果按 IPv6 能力分支，使用 Is6()。如果日志、去重键或规则匹配希望把两种 IPv4 表示统一起来，可以先调用 Unmap()，再对结果调用 Is4() 或 String()。

func classify(text string) (string, error) {
	// 解析错误交给调用方处理，避免把无效文本误归类成某种地址族。
	addr, err := netip.ParseAddr(text)
	if err != nil {
		return "invalid", err
	}

	// Unmap 只改变 IPv4-mapped IPv6；普通 IPv4 和普通 IPv6 保持原语义。
	normalized := addr.Unmap()
	if normalized.Is4() {
		return "ipv4", nil
	}
	if normalized.Is6() {
		return "ipv6", nil
	}
	return "zero", nil
}

不要用字符串形态代替地址族判断

Addr.String() 适合展示或输出，不适合承担地址族判定。IPv4-mapped IPv6 的字符串会保留 ::ffff: 前缀；如果用“是否包含冒号”之类的规则，代码会把表示形式和类型语义混在一起，后续遇到 zone、零值或格式变化时更难维护。

还要注意两个边界：

• Is4() 和 Is4In6() 是互补判断，不是同义方法。映射地址通常是 Is4=false、Is4In6=true。
• Unmap() 是归一化动作，不是验证输入文本的替代品。文本仍应先通过 ParseAddr 检查错误。

因此，推荐把 API 选择写成业务意图：需要原生 IPv4 就用 Is4，需要识别映射关系就用 Is4In6，需要统一键值就先 Unmap。这样比维护一套字符串规则更直接。

相关问题

IPv4-mapped IPv6 为什么 Is4 返回 false？

因为 netip 把它保留为 IPv6 地址语义，Is6() 会返回 true。只有调用 Unmap() 去除映射前缀后，得到的地址才会被 Is4() 识别为原生 IPv4。

只想判断 IPv4，是否还要先调用 IsValid？

对来自 ParseAddr 的成功结果，直接调用 Is4() 即可；如果 Addr 可能是零值或由多个来源拼装，先用 IsValid() 区分未初始化值，再按业务需要判断地址族。