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