networkQuality报告以吞吐量和延迟为核心指标，不反映信号强度或丢包率；测速走苹果CDN，受代理/PAC影响，需用iperf3验证内网真实带宽。
无线诊断工具生成的 networkQuality 报告怎么看
MacOS 自带的无线诊断（Wireless Diagnostics）启动后点「窗口 → 网络报告」，实际输出的是 networkQuality 命令的底层数据。它不直接显示「信号强度」或「丢包率」，而是用吞吐量（downloadMbps / uploadMbps）和延迟（latencyMs）作为核心指标——这意味着你不能靠它判断 AP 是否过载或信道干扰，只能验证当前连接下的真实可用带宽。
常见错误现象：networkQuality 显示下载 800 Mbps，但 Safari 下载大文件只有 2 MB/s（≈16 Mbps）。这是因为该命令走的是 HTTP/HTTPS 测速（默认连苹果 CDN），绕过了本地 DNS、代理、防火墙策略甚至浏览器缓存逻辑。
- 实操建议：测速前先关闭所有代理设置（
System Settings → Network → Details → Proxies） - 如果网络走企业 PAC 文件，
networkQuality结果完全不可信，换用iperf3 -c <内网服务器IP>更准 - 注意报告里
testDate是 UTC 时间，不是本地时区，别误判发生时间
为什么 Wireless Diagnostics 扫不到 5GHz 信道或 Wi-Fi 6 设备
不是工具坏了，是 macOS 的无线驱动层（IO80211Family）对某些芯片支持滞后。比如 Intel AX200/AX210 在 macOS 13.5 之前根本不会上报 HE（Wi-Fi 6）能力字段，诊断工具自然识别为「802.11ac」；M2 Mac 上部分雷电扩展网卡也因固件限制无法暴露 DFS 信道扫描结果。
使用场景：排查会议室连不上 5GHz 网络时，别只信诊断工具的「已连接频段」栏——它可能把 5GHz 连接错误标记为「2.4GHz」，因为底层没拿到正确的 phyMode 值。
- 确认真实频段：终端运行
airport -I | grep agrCtlRSSI，看输出里的channel值是否带:（如44:80表示 5GHz 的 44 信道，80MHz 宽带） - Wi-Fi 6 设备兼容性检查：运行
system_profiler SPAirPortDataType | grep "PHY Mode"，输出含HE才真支持 - 旧机型（如 2015 MBP）即使连上 Wi-Fi 6 路由器，诊断工具也只会显示
802.11ac，这是硬件限制，不是配置问题
awdl 和 p2p 接口异常导致诊断卡在「正在分析」
无线诊断工具依赖 macOS 底层的 awdl（Apple Wireless Direct Link）和 p2p（Wi-Fi P2P）接口做邻居发现与信标采集。如果这两个虚拟接口被禁用、冲突或驱动异常，工具会卡在「正在分析」超过 90 秒，最终弹窗提示「无法完成诊断」，但不会说明具体原因。
典型触发条件：装过黑苹果补丁、用过 tcpdump 抓过 awdl0 流量、或启用了第三方网络过滤工具（如 Little Snitch 的「阻止所有新连接」模式）。
- 快速验证：终端执行
ifconfig awdl0 p2p0，若报device not found，说明接口未启用 - 临时恢复：运行
sudo ifconfig awdl0 up和sudo ifconfig p2p0 up（需输入密码） - 永久修复：重置网络位置（
System Settings → Network → Location → Edit Locations → + → Delete old one），系统会重建接口绑定
导出的 .wdiag 文件怎么手动解析
.wdiag 不是加密文件，本质是 ZIP 包，解压后核心是 report.json 和 scan.csv。很多人双击用「无线诊断」打开只能看到汇总页，但真正有用的原始扫描数据（比如每个 AP 的 RSSI、噪声、信道利用率）全藏在 CSV 里。
性能影响：直接双击打开大体积 .wdiag（>10MB）会触发 GUI 全量加载，卡顿明显；而命令行解压+awk 提取，3 秒内搞定。
- 实操步骤：
unzip -p your.wdiag report.json | jq '.summary.downloadMbps'（需提前brew install jq） - 查干扰源：
unzip -p your.wdiag scan.csv | awk -F, '$5 > -70 {print $1,$5}' | sort -k2nr（筛选 RSSI > -70dBm 的强干扰 AP） - 注意：macOS 14+ 导出的
.wdiag默认含隐私脱敏字段（如 SSID 显示为<private>），无法还原真实名称
最常被忽略的一点：诊断工具默认只抓取当前网络的 1 分钟数据，但信道拥塞、DFS 雷达事件这类问题往往需要连续 5–10 分钟观测。真要定位间歇性故障，得用 airport -s 配合 watch -n 2 "airport -s" 手动轮询，别只依赖单次诊断报告。
