macos 内置 networkquality 工具可标准化测速，输出带宽、延迟、抖动及丢包率；支持默认测试、详细日志（-v）、自定义服务器（-s/-p）、时长与并发控制（-l/-n）及 json 结果导出。

如果您需要在 macOS 系统中对当前网络连接进行标准化测速与质量评估，则可直接调用系统内置的命令行工具 networkQuality。该工具由 Apple 官方提供，无需额外安装，能输出带宽、延迟、抖动及丢包率等关键指标。以下是其具体应用方式：

一、基础测速指令执行

networkQuality 默认以标准模式运行，向 Apple 指定服务器发起 HTTP/HTTPS 测速请求，获取上行与下行吞吐量、往返时间（RTT）及连接稳定性数据。该模式适用于快速判断当前网络整体性能。

1、打开“终端”应用（可通过 Spotlight 搜索 Terminal 或在“应用程序 → 实用工具”中找到）。

2、输入命令：networkQuality，然后按回车键执行。

3、等待约 15–30 秒，工具自动完成测试并输出 JSON 格式结果，包含 uploadMbps、downloadMbps、observedMinRTTMs 等字段。

二、启用详细日志模式

添加 -v 参数可启用详细输出模式，显示每阶段测试过程、各轮次 RTT 样本、重传统计及协议协商细节，便于定位网络异常环节（如 TLS 握手延迟、TCP 重传激增等）。

1、在终端中输入：networkQuality -v，回车执行。

2、观察逐行打印的调试信息，重点关注 “Starting upload test”、“Measuring RTT”、“Retransmission count” 等标记行。

3、测试结束后，完整日志将保留在终端窗口中，可复制保存用于进一步分析。

三、指定目标服务器与端口

使用 -s 和 -p 参数可将测速目标切换至自定义 HTTPS 服务器及端口，验证特定业务链路质量（例如企业内部 API 网关或 CDN 节点），绕过默认 Apple 服务器限制。

1、确保目标服务器支持 HTTPS 并已开放对应端口（如 443 或 8443）。

2、输入命令：networkQuality -s example.com -p 443，将 example.com 替换为实际域名。

3、工具将尝试建立 TLS 连接到该地址，并执行完整上传/下载/延迟测试流程。

四、限制测试时长与样本数量

通过 -L（最长持续时间，单位秒）和 -n（最大并发流数）参数可控制资源占用强度，适用于后台轻量监控或低功耗设备场景，避免影响前台应用网络使用。

1、若需将单次测试压缩至 10 秒内，运行：networkQuality -L 10。

2、若需降低并发压力，仅启用单流测试，运行：networkQuality -n 1。

3、二者可组合使用，例如：networkQuality -L 8 -n 1，实现最小化干扰的快速采样。

五、导出结构化结果至文件

networkQuality 原生支持将 JSON 输出重定向至本地文件，便于脚本解析、历史比对或集成至自动化运维流程，无需第三方转换工具。

1、在终端中输入：networkQuality > ~/Desktop/network_result.json。

2、测试完成后，打开访达，前往桌面，确认生成名为 network_result.json 的文件。

3、可用文本编辑器或命令行工具（如 jq）读取该文件，提取 downloadMbps 数值：jq '.downloadMbps' ~/Desktop/network_result.json。