如何让Go的netip包输出不含点分四段的IPv4映射IPv6字符串？

netip包的Addr.String()方法遵循RFC 5952规范，会默认将IPv4-mapped IPv6地址的低32位以IPv4点分十进制格式输出，没有内置选项直接修改这一行为。要实现浏览器地址栏的格式化效果，需要手动构造目标格式的字符串。

实现思路 #

1. 过滤目标地址类型：仅处理符合::ffff:/96前缀的IPv4-mapped IPv6地址
   • 必须是IPv6地址（Is6()返回true）
   • 属于IPv4嵌入IPv6的类型（Is4In6()返回true）
   • 前80位为0、接下来16位为ffff
2. 提取地址最后4字节，拆分为两个16位十六进制段
3. 拼接成::ffff:xxxx:xxxx格式；非目标类型地址直接返回默认格式化结果

代码示例 #

package main

import (
	"encoding/hex"
	"fmt"
	"log"
	"net/netip"
)

// formatIPv4MappedAsHex 将IPv4-mapped IPv6地址格式化为带十六进制低32位的形式
func formatIPv4MappedAsHex(ip netip.Addr) string {
	// 过滤非目标类型地址
	if !ip.Is6() || !ip.Is4In6() {
		return ip.String()
	}

	b := ip.As16()
	// 验证前缀是否为::ffff:/96
	prefixValid := true
	for i := 0; i < 10; i++ {
		if b[i] != 0 {
			prefixValid = false
			break
		}
	}
	if b[10] != 0xff || b[11] != 0xff {
		prefixValid = false
	}
	if !prefixValid {
		return ip.String()
	}

	// 拆分最后4字节为两个十六进制段
	part1 := hex.EncodeToString(b[12:14])
	part2 := hex.EncodeToString(b[14:16])
	return fmt.Sprintf("::ffff:%s:%s", part1, part2)
}

func main() {
	ip, err := netip.ParseAddr("::ffff:7f7f:7f7f")
	if err != nil {
		log.Fatal(err)
	}

	fmt.Println("默认格式化结果:", ip.String())       // 输出: ::ffff:127.127.127.127
	fmt.Println("自定义格式化结果:", formatIPv4MappedAsHex(ip)) // 输出: ::ffff:7f7f:7f7f
}

说明 #

• 该函数仅对标准::ffff:/96前缀的IPv4-mapped IPv6地址生效，其他类型IP地址（普通IPv6、纯IPv4等）仍保持默认格式化逻辑
• 手动构造的格式完全匹配浏览器地址栏的显示规则，能精准输出目标格式

内容的提问来源于stack exchange，提问作者jub0bs