darrylmorley/whatcable

这是什么？

核心功能

• 01以一句话标明每个端口的状态，如仅充电、USB 设备或雷电 / USB4。
• 02诊断充电瓶颈，例如线缆额定功率低于充电器。
• 03从 e-marker 读取线缆速率、电流规格和芯片厂商。
• 04列出充电器支持的全部电压档位，并高亮当前协商的档位。
• 05显示雷电链路的通道速率、代数及多级拓扑。
• 06提供支持 JSON 输出和实时监视的命令行工具。

适用场景

• 更换线缆或充电器后，排查 Mac 充电变慢的原因。
• 购买扩展坞前，确认线缆是否支持雷电或 40 Gbps 数据传输。
• 排查 USB 设备或扩展坞速率低于预期的问题。
• 通过命令行的 JSON 输出，在脚本中自动检查 USB-C 端口状态。

快速上手

1. 1

   使用 Homebrew 安装菜单栏应用

   brew install --cask darrylmorley/whatcable/whatcable
2. 2

   或仅安装命令行工具

   brew install darrylmorley/whatcable/whatcable-cli
3. 3

   运行命令行工具查看每个端口的摘要

   whatcable

使用前须知

• !仅支持 Apple Silicon 芯片的 Mac，Intel Mac 无法提供所需的 USB-C 端口数据。
• !需要 macOS 14（Sonoma）或更高版本。
• !部分高级功能（实时功率监测、诊断、仪表板）需要付费的 WhatCable Pro 许可证。

标签

常见问题

whatcable 是什么？

一款 macOS 菜单栏应用，用通俗语言说明 Mac 上每根 USB-C 线缆的实际能力，并解释充电变慢的原因。 USB-C 接口外形相同，但背后可能是只能充电的 USB 2.0 线，也可能是 240W 的雷电 4 线。WhatCable 读取 macOS 通过 IOKit 提供的端口、充电器、设备和线缆数据，在菜单栏弹窗中按端口展示线缆的速率和电流规格、充电器支持的电压档位、实际协商的功率，并指出瓶颈位于哪一环。

whatcable 可以免费使用吗？用的什么许可证？

whatcable 以 Other 许可证开源。用于商业产品前，请先确认许可证条款。

whatcable 还在维护吗？

活跃维护中。whatcable 最近一次提交是在 2026年10月13日。

whatcable 适合用来做什么？

更换线缆或充电器后，排查 Mac 充电变慢的原因。 购买扩展坞前，确认线缆是否支持雷电或 40 Gbps 数据传输。 排查 USB 设备或扩展坞速率低于预期的问题。 通过命令行的 JSON 输出，在脚本中自动检查 USB-C 端口状态。

whatcable 怎么安装和运行？

使用 Homebrew 安装菜单栏应用: brew install --cask darrylmorley/whatcable/whatcable 或仅安装命令行工具: brew install darrylmorley/whatcable/whatcable-cli 运行命令行工具查看每个端口的摘要: whatcable

在哪里获取 whatcable？

源代码和安装说明在 GitHub 上：https://github.com/darrylmorley/whatcable