Windows下获取网络适配器列表最可靠方式是调用GetAdaptersAddresses,它支持IPv4/IPv6、MAC地址、网关、DNS等完整信息,需两次调用(先获缓冲区大小再填充),传AF_UNSPEC获取双栈地址,遍历FirstUnicastAddress链表提取IP,并检查OperStatus判断启用状态。

Windows下用GetAdaptersAddresses获取适配器和IP
Windows平台最可靠的方式是调用GetAdaptersAddresses,它能一次性返回IPv4/IPv6地址、子网掩码、网关、DNS、接口索引等完整信息,且兼容WinXP及以上系统。别用已废弃的GetAdaptersInfo——它不支持IPv6,字段也更少。
关键点:GetAdaptersAddresses需要两次调用:第一次传NULL获取所需缓冲区大小,第二次分配足够内存再调用。忽略这个步骤会直接返回ERROR_BUFFER_OVERFLOW。
- 必须链接
Iphlpapi.lib,并在源文件包含#include <iphlpapi.h></iphlpapi.h> - 调用时
Family参数设为AF_UNSPEC才能同时拿到IPv4和IPv6地址 - 遍历返回的
IP_ADAPTER_ADDRESSES链表时,每个节点的FirstUnicastAddress指向该适配器所有IP地址链表(含IPv4/IPv6),需逐个读取Address.lpSockaddr并用getnameinfo转成字符串 - 注意
OperStatus字段判断是否启用(IfOperStatusUp),避免列出禁用或未连接的适配器
Linux下用getifaddrs替代ioctl(SIOCGIFCONF)
getifaddrs比传统ioctl方式更简洁安全,自动处理AF_PACKET、AF_INET、AF_INET6等多种地址族,且无需预估缓冲区大小。glibc 2.1+均支持,主流发行版无兼容性问题。
常见坑:返回的ifaddrs结构体中,ifa_addr可能为NULL(如lo接口无IP),或ifa_addr->sa_family不是AF_INET/AF_INET6(比如AF_PACKET)。必须先判空再取地址族。
直播话术巡检系统(Windows版) — 实时语音转写、关键词检测、场景自动切换、告警推送、大屏可视化。支持 Windows VB-Cable 虚拟声卡音频采集,阿里云 ASR 实时识别。一键启动脚本,自动安装环境。
立即学习“C++免费学习笔记(深入)”;
- 记得调用
freeifaddrs释放内存,否则泄漏 -
ifa_name是接口名(如"eth0"),但不能直接当“适配器名称”用——它不含中文描述,也不反映物理设备型号 - 若需MAC地址,从
ifa_addr类型为AF_PACKET的节点中提取sa_data[0..5],注意字节序无需转换 - IPv6地址可能带作用域ID(如
"fe80::1%lo"),解析时需用getnameinfo配合NI_NUMERICHOST标志
跨平台封装要注意的三件事
想写一次代码跑两边,核心难点不在获取数据,而在统一抽象层设计。不同系统对“适配器”的定义差异很大:Windows有FriendlyName、Description;Linux只有接口名;macOS还有en0这类命名规则。
- 不要试图把Windows的
AdapterName(如"{A1B2C3D4-...}")或Linux的ifa_name直接当用户可见名——它们都不直观。建议额外查ethtool -i(Linux)或WMI(Windows)补设备型号,但代价高,多数场景用接口名+IP组合更实际 - IPv6地址有效性判断不能只看
sa_family:Linux下getifaddrs可能返回临时地址(IFA_F_TEMPORARY)、deprecated地址,Windows下对应PrefixOrigin和SuffixOrigin字段,需过滤 - 权限问题:Linux下读取某些字段(如MAC)通常不需要root,但部分虚拟接口或容器环境可能受限;Windows下普通用户可调用
GetAdaptersAddresses,无需管理员权限
容易被忽略的边界情况
真实环境中,适配器列表远比示例代码复杂:隧道接口(如wintun、utun)、虚拟网卡(Hyper-V、Docker bridge)、多宿主绑定(同一IP绑多个接口)、IPv6 privacy extensions生成的临时地址……这些都会让getifaddrs或GetAdaptersAddresses返回大量条目。
- Windows下
Ipv6IfIndex和Ipv4IfIndex可能不同,意味着同一物理接口在IPv4/IPv6下被视为两个逻辑接口 - Linux下
lo回环接口总存在,但其IPv6地址::1常被误认为可用公网地址,需结合ifa_flags & IFF_UP和!(ifa_flags & IFF_LOOPBACK)双重过滤 - 某些嵌入式Linux或旧内核(getifaddrs,fallback方案只能用
NETLINK_ROUTEsocket,复杂度陡增

















