Windows用GetAdaptersAddresses(需两次调用、检查PhysicalAddressLength)、Linux用getifaddrs过滤AF_PACKET或读/sys/class/net/,跨平台需过滤虚拟接口、校验MAC有效性并安全格式化输出。

Windows 下用 GetAdaptersAddresses 获取适配器列表和 MAC 地址
在 Windows 上,GetAdaptersAddresses 是最可靠、跨版本(XP SP1+)的标准 API,能同时拿到名称、描述、IPv4/IPv6 地址、状态,以及关键的物理地址(MAC)。它比过时的 GetAdaptersInfo 更健壮,支持 IPv6 且内存管理更清晰。
实操要点:
- 必须链接
Iphlpapi.lib,并在代码开头#include <iphlpapi.h> - 调用前先传
NULL获取所需缓冲区大小,再分配内存重试——这是最容易漏掉的步骤,否则返回ERROR_BUFFER_OVERFLOW - 遍历返回的
IP_ADAPTER_ADDRESSES链表时,检查PhysicalAddressLength == 6再取PhysicalAddress[6],避免读越界(有些适配器如隧道接口长度为 0) - 注意
AdapterName是内部标识符(如"{8E9C273D-...}"),要显示友好名得读FriendlyName字段(宽字符)
ULONG size = 0;
GetAdaptersAddresses(AF_UNSPEC, GAA_FLAG_INCLUDE_PREFIX, nullptr, nullptr, &size);
auto buf = std::make_unique<BYTE[]>(size);
PIP_ADAPTER_ADDRESSES addr = reinterpret_cast<PIP_ADAPTER_ADDRESSES>(buf.get());
GetAdaptersAddresses(AF_UNSPEC, GAA_FLAG_INCLUDE_PREFIX, nullptr, addr, &size);
for (auto p = addr; p; p = p->Next) {
if (p->PhysicalAddressLength == 6) {
printf("%02X:%02X:%02X:%02X:%02X:%02X\n",
p->PhysicalAddress[0], p->PhysicalAddress[1],
p->PhysicalAddress[2], p->PhysicalAddress[3],
p->PhysicalAddress[4], p->PhysicalAddress[5]);
}
}Linux 下用 getifaddrs 遍历接口并过滤 AF_PACKET
getifaddrs 是 POSIX 兼容方案,在 Linux/macOS 上通用。但要注意:它本身不直接暴露 MAC,需找到类型为 AF_PACKET 的地址条目,再从 sockaddr_ll 中提取 sll_addr。
常见陷阱:
立即学习“C++免费学习笔记(深入)”;
- 不是所有接口都有
AF_PACKET条目(比如 lo 在某些内核配置下可能没有),需 fallback 到读/sys/class/net/<ifname>/address -
getifaddrs返回链表中同一接口可能有多个地址(IPv4、IPv6、LLDP 等),必须严格比对ifa_addr->sa_family == AF_PACKET -
sll_addr长度由sll_halen决定,通常为 6,但不能硬编码;需用std::vector<uint8_t>(addr->sll_addr, addr->sll_addr + addr->sll_halen)安全拷贝
struct ifaddrs* ifa = nullptr;
if (getifaddrs(&ifa) == 0) {
for (auto p = ifa; p; p = p->ifa_next) {
if (p->ifa_addr && p->ifa_addr->sa_family == AF_PACKET) {
auto ll = reinterpret_cast<struct sockaddr_ll*>(p->ifa_addr);
if (ll->sll_halen == 6) {
printf("%02x:%02x:%02x:%02x:%02x:%02x\n",
ll->sll_addr[0], ll->sll_addr[1],
ll->sll_addr[2], ll->sll_addr[3],
ll->sll_addr[4], ll->sll_addr[5]);
}
}
}
freeifaddrs(ifa);
}跨平台封装时别忽略权限与虚拟接口干扰
即使逻辑正确,实际运行仍可能拿不到真实 MAC:普通用户在 Linux 下无法读某些虚拟网卡(如 Docker bridge),Windows 上 Hyper-V 虚拟交换机适配器也可能返回全零或随机 MAC。
应对方式:
- Linux 下若
getifaddrs拿不到,尝试打开/sys/class/net/<ifname>/address—— 这个路径不需要 root,且对所有 netdev 都有效 - Windows 上过滤掉
IF_TYPE_SOFTWARE_LOOPBACK和IF_TYPE_TUNNEL类型(查IfType字段),避免把 127.0.0.1 或 WSL2 虚拟网卡当真实网卡 - 永远校验 MAC 是否全零(
00:00:00:00:00:00)或全 F(FF:FF:FF:FF:FF:FF),这些是无效值,应跳过
std::string 拼接 MAC 时小心字节序和格式
物理地址是字节数组,不是字符串。直接用 std::string 构造会截断(遇到 \0 就停),且十六进制输出必须补零对齐,否则 0a:0b:c 这种错位格式会干扰后续解析。
安全做法:
- 用
std::ostringstream或 C++20std::format(若可用)逐字节格式化,确保两位十六进制 - 不要依赖
inet_ntoa或类似网络地址函数——它们不处理 MAC - 如果最终要 JSON 输出,记得转义冒号或改用短横线分隔(如
"00-1A-2B-3C-4D-5E"),避免某些解析器把冒号当分隔符
跨平台代码里最易被忽略的是:Windows 的 GetAdaptersAddresses 默认不返回已禁用的适配器,而 Linux 的 getifaddrs 会返回 down 状态的接口;若业务需要“所有曾经存在过的网卡”,就得额外调用 GetIfTable2(Win)或扫描 /sys/class/net/(Linux)。


















