networkQuality 不测宽带实际速度，只评估设备到Apple CDN节点的单向网络质量，输出uplinkCapacityMbps、downlinkCapacityMbps（理论通道能力，非实时带宽）及latencyMs、packetLoss等指标。
networkQuality 命令根本测不了“你家宽带速度”
它只测设备到 Apple CDN 节点的单向网络质量（延迟、丢包、吞吐），不是 speedtest 那种端到端下载/上传压测。结果里没有“Mbps”单位，只有 uplinkCapacityMbps 和 downlinkCapacityMbps —— 这两个是 Apple 估算的**理论通道能力**，不是实时带宽占用值。
常见错误现象：networkQuality 执行后卡住、返回 Error: No network connectivity、或数值远低于预期（比如显示 downlinkCapacityMbps 为 12，但你知道自己装的是 500M 宽带）。
- 它默认走 HTTPS + QUIC 连接 Apple 的
networkquality.apple.com，如果公司网络屏蔽了该域名或限制 QUIC，就会失败 - 不走本地路由器测速逻辑，不反映 Wi-Fi 信号衰减、信道干扰、DNS 延迟等真实瓶颈
- macOS 12.3+ 才内置，旧系统运行会报
command not found
怎么正确运行 networkQuality 并看懂输出
直接在终端敲 networkQuality 即可启动，默认测试约 15 秒，完成后输出 JSON 格式结果。关键字段不是“速度”，而是三组容量与延迟：
-
uplinkCapacityMbps：上行理论能力（注意不是你上传文件的速度） -
downlinkCapacityMbps：下行理论能力（不是测速网站显示的下载速率） -
latencyMs：到 Apple 节点的平均往返延迟（比 ping 更贴近实际应用层） -
packetLoss：测试期间估算的丢包率（非 ICMP，是基于 HTTP/3 流量）
示例片段：
{"uplinkCapacityMbps":24.8,"downlinkCapacityMbps":92.1,"latencyMs":28.4,"packetLoss":0.0} —— 这不代表你正在用 92Mbps 下载，只是当前链路被评估出有这个潜力。
networkQuality 的 -v 参数和超时陷阱
加 -v 可看到详细连接过程，对排查失败特别有用；但别加 -t（自定义超时），macOS 13.4+ 后该参数已被移除，强行使用会报 unrecognized option '-t'。
- 默认超时约 30 秒，若网络不稳定，可能提前中止并返回空结果或部分字段为 null
- 加
-v后能看到具体连哪个 IP、是否协商 QUIC 成功、TLS 握手耗时——这些才是定位问题的关键线索 - 企业环境常因代理或防火墙拦截
networkquality.apple.com:443导致失败，此时-v输出里会出现Failed to connect或TLS handshake failed
它适合什么场景，不适合什么场景
适合快速验证 macOS 网络栈基础连通性是否异常，比如判断是 Wi-Fi 模块问题、还是系统级网络配置错乱；不适合替代 iperf3 或网页测速工具做带宽验收。
- 适合：开发调试网络请求超时逻辑、排查 MDM 管理下设备联网异常、确认 macOS 是否识别出 5GHz Wi-Fi 频段能力
- 不适合：对比不同 ISP 带宽、测路由器 NAT 性能、验证光纤入户是否达标、判断视频会议卡顿原因（它不模拟 UDP 流量）
- 注意：同一台 Mac 在不同时间跑
networkQuality，结果波动可能很大——因为后端节点动态调度，不是固定服务器
真正影响体验的，往往是 DNS 解析慢、TCP 重传多、TLS 1.3 回退到 1.2，而这些 networkQuality 都不暴露。它只告诉你“苹果认为这条路理论上能跑多快”，而不是“你现在正跑得多快”。
