getaddrinfo更推荐，因其是POSIX标准现代接口，支持IPv4/IPv6双栈、线程安全、可指定协议族与套接字类型；而gethostbyname已废弃，仅支持IPv4、非线程安全且无法定制解析行为。
getaddrinfo 为什么比 gethostbyname 更推荐
因为 gethostbyname 已废弃，不支持 IPv6、线程不安全、无法指定协议族或 socket 类型。而 getaddrinfo 是 POSIX 标准的现代接口，能同时处理 IPv4/IPv6、TCP/UDP、阻塞/非阻塞场景，且返回结构体链表可直接用于 socket + connect 或 bind。
常见错误是传错 hints.ai_family：设成 AF_INET 就只能查 IPv4，设成 AF_UNSPEC 才可能返回双栈结果；另外漏设 hints.ai_socktype 或 hints.ai_protocol 可能导致返回多个冗余条目（比如同一个 IP 返回 TCP 和 UDP 两套地址）。
实操建议：
- 始终初始化
hints结构体为零：struct addrinfo hints = {}; - 至少设置
hints.ai_family = AF_UNSPEC和hints.ai_socktype = SOCK_STREAM（如需 TCP） - 调用后必须用
freeaddrinfo释放内存，否则内存泄漏 - 检查返回值是否为 0，非 0 时用
gai_strerror打印错误，例如EAI_NONAME表示域名不存在，EAI_AGAIN表示 DNS 查询超时
如何正确解析域名并提取第一个可用 IPv4 或 IPv6 地址
多数场景只需一个可用地址（比如建立连接），不需要遍历整个 addrinfo 链表。关键点在于：不能假设第一个节点就是 IPv4，也不能硬编码取 sin_addr 字段——IPv6 节点对应的是 sin6_addr。
立即学习“C++免费学习笔记（深入）”；
实操建议：
- 遍历
result链表，用ai->ai_family == AF_INET或ai->ai_family == AF_INET6判断类型 - 用
getnameinfo安全提取 IP 字符串（自动适配 v4/v6），避免手动强转sockaddr_in*导致越界 - 若只要 IPv4，可在
hints.ai_family = AF_INET；但注意某些内网环境（如 Kubernetes）可能只配置了 AAAA 记录，强制限定反而失败 - 示例中提取首个 IPv4 地址的逻辑：
for (auto* ai = result; ai; ai = ai->ai_next) { if (ai->ai_family == AF_INET) { auto* sin = (sockaddr_in*)ai->ai_addr; char ip[INET_ADDRSTRLEN]; if (inet_ntop(AF_INET, &sin->sin_addr, ip, sizeof(ip))) { printf("IPv4: %s\n", ip); break; } } }
getaddrinfo 在 Windows 上的兼容性注意事项
Windows 下必须先调用 WSAStartup 初始化 Winsock，否则 getaddrinfo 直接返回 WSANOTINITIALISED（对应错误码 10093）。这个错误不触发 gai_strerror，容易误判为域名问题。
另一个坑是：MinGW 或较老的 MSVC 版本可能没有完整实现 getaddrinfo 的 IPv6 支持，尤其在 ai_flags 使用 AI_ADDRCONFIG 时行为异常——它本意是“只返回本地网络支持的地址族”，但在某些 Windows 版本会过滤掉本应存在的 IPv6 地址。
实操建议：
- Windows 环境下务必检查
WSAStartup返回值，且在程序退出前调用WSACleanup - 避免依赖
AI_ADDRCONFIG，改用AF_UNSPEC+ 应用层过滤更可靠 - 跨平台构建时，确保链接
ws2_32.lib（MSVC）或-lws2_32（GCC）
异步解析或超时控制不能靠 getaddrinfo 本身实现
getaddrinfo 是同步阻塞函数，DNS 查询慢会导致整个线程卡住。它不接受超时参数，也没有异步回调机制。想做超时，必须自己封装：要么开线程 + join 带时限，要么用 select/poll 配合非阻塞 socket（但 DNS 协议本身不支持非阻塞解析）。
更现实的做法是用第三方库（如 c-ares）或系统级方案（如 Linux 的 systemd-resolved socket 接口），但纯标准 C++ 不提供替代方案。
实操建议：
- 不要在主线程或实时敏感路径中直接调用
getaddrinfo - 若必须同步，可设较短超时（如 3 秒），用线程 +
std::future::wait_for包装 - 生产环境建议预解析并缓存结果，或使用支持异步的 DNS 库
- 注意 glibc 的
getaddrinfo默认读/etc/resolv.conf，容器中若挂载空目录或没配置 nameserver，会静默失败
真正麻烦的不是写对那几行调用，而是得同时盯住 DNS 配置、系统 resolver 行为、线程模型和错误码分支——这些地方一漏，问题就藏得深。
