inet_pton是最可靠的IPv6地址解析方式，专为处理双冒号缩写、嵌入IPv4、zone ID等合法变体设计，需注意头文件、空格、缓冲区大小及返回值含义。
用 inet_pton 是最可靠的方式
直接调用系统 API 比手写正则或手动解析更准，也避开了 IPv6 地址中各种合法变体（如双冒号缩写、嵌入 IPv4 的 ::ffff:192.0.2.1）带来的边界问题。inet_pton 专为这种场景设计，且被所有主流平台支持。
注意：它只做语法和格式校验，不检查地址是否路由可达或是否属于保留范围。
- 必须包含
<arpa/inet.h>（Linux/macOS）或<>Ws2tcpip.h>（Windows，还需链接ws2_32.lib） - 传入地址字符串前要确保无首尾空格，否则返回 0（失败）
- 目标缓冲区大小必须为
sizeof(struct in6_addr)，即 16 字节，小了会越界，大了也没用 - 返回值为 1 表示成功，0 表示格式无效，-1 表示 family 不支持（比如传了
AF_INET却给 IPv6 字符串）
struct in6_addr addr; int ret = inet_pton(AF_INET6, "2001:db8::1", &addr); // ret == 1 表示是有效 IPv6 字符串
手写解析前先搞清 IPv6 字符串的合法结构
IPv6 字符串不是简单“8组十六进制数用冒号分隔”。真正合法形式包括：
- 完整格式：
2001:0db8:85a3:0000:0000:8a2e:0370:7334 - 省略前导零：
2001:db8:85a3:0:0:8a2e:370:7334 - 双冒号压缩（只能出现一次）：
2001:db8:85a3::8a2e:370:7334 - 嵌入 IPv4：
::ffff:192.0.2.1或2001:db8::192.0.2.1 - 带 IPv6 zone ID（仅限链路本地）：
fe80::1%eth0——%后不是地址一部分，解析时应截断
如果你的场景明确不需要 zone ID 或嵌入 IPv4，可以简化逻辑；但只要涉及真实网络交互（比如解析用户输入或配置文件），就得覆盖这些情况，否则会漏判。
立即学习“C++免费学习笔记（深入）”；
C++ Code Review Master
下载
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
用正则匹配容易踩的坑
C++ 标准库 std::regex 性能差、编译慢，而且写一个完全正确的 IPv6 正则非常反直觉。常见错误包括：
- 没处理双冒号位置：正则写成
^([0-9a-fA-F]{1,4}:){7}[0-9a-fA-F]{1,4}$会漏掉::1 - 没限制段数：允许
::::这种非法重复双冒号 - 没转义点号：在嵌入 IPv4 部分把
.当通配符，导致192x0x2x1也被接受 - 忽略大小写：IPv6 十六进制字母可大可小，正则需加
std::regex_constants::icase
如果非要用正则（例如嵌入 DSL 或日志过滤），推荐复用经过验证的表达式，比如 ICU 或 Boost.Regex 中的现成模式，而不是自己从头推导。
Windows 上 InetPton 和 WSAStringToAddress 的区别
Windows 下有两个类似函数：InetPton（推荐）和更老的 WSAStringToAddress。关键差异在于：
-
InetPton行为与 POSIXinet_pton一致，语义清晰，参数少，出错只返回 -1/0/1 -
WSAStringToAddress需要传入 sockaddr 结构指针和长度指针，还要求调用方预先分配足够空间，容易因namelen填错导致静默截断 -
WSAStringToAddress在遇到 zone ID（如%eth0）时可能失败，而InetPton会忽略%及之后内容（符合 RFC 4007） - 从 Windows Vista 起，
InetPton已稳定可用，无需额外条件编译
除非维护遗留代码，否则一律选 InetPton。
双冒号展开、zone ID 截断、嵌入 IPv4 解析——这些细节在实际网络配置中频繁出现，靠字符串切分+逐段 std::stoi(..., nullptr, 16) 极易出错。系统 API 就是为此而生的，别绕远路。
