WhatCable：一眼看穿你的 USB-C 线缆到底能干什么

原文来源：WhatCable —— 开源免费的 macOS 菜单栏工具，告诉你每根 USB-C 线缆的真实传输能力和充电规格。

你的抽屉里是不是也有一堆长得一模一样的 USB-C 线，每次用的时候都要挨个试？有些充得飞快，有些慢得像蜗牛，有些能接显示器，有些连鼠标都驱动不了。插头长得一模一样——没有任何办法区分它们。

这个问题不只是让你烦恼。USB-C 接口隐藏了极其复杂的规格差异：同一种接口形状的线缆可能是 USB 2.0 纯充电线，也可能是 240W / 40Gbps 的 Thunderbolt 4 线缆。你根本看不出来。

WhatCable 就是为了解决这个问题而生的。它是一个开源的 macOS 菜单栏工具，利用 macOS 系统原生暴露的 IOKit 数据，以通俗易懂的语言告诉你每根线缆的真实能力。

能看什么

WhatCable 会为每个 USB-C 端口显示：

一目了然的摘要信息：

• Thunderbolt / USB4
• USB 设备
• 纯充电线
• 慢速 USB / 仅充电线缆
• 无设备连接

充电诊断：当有设备插入时，会显示瓶颈在哪里：

• 「线缆限制了充电速度」（线缆额定功率低于充电器）
• 「以 30W 充电」（充电器最高支持 96W，但 Mac 当前需求较低）
• 「以 96W 正常充电」（所有环节匹配）

线缆 E-Marker 信息：线缆的实际速度（USB 2.0、5/10/20/40/80 Gbps）、电流等级（3A / 5A 最高 60W/100W/240W）、以及芯片厂商。

线缆可信度信号：当 E-Marker 报告的值看起来异常时（比如零厂商 ID、速度/电流/线缆延迟字段的保留位模式、不在 USB-IF 公开发布列表中的 VID），会显示橙色卡片提示。

充电器 PDO 列表：充电器宣传的每个电压档位（5V/9V/12V/15V/20V…），实时高亮当前协商档位。

已连接设备身份：从 PD 发现身份响应中解析出的厂商名称和产品类型。

连接的 USB 设备：存储设备、集线器、外设列在物理端口下，带协商速度。

活跃传输模式：USB 2 / USB 3 / Thunderbolt / DisplayPort。

安装方式

WhatCable 可以通过多种方式安装：

直接下载：从 GitHub Releases 下载最新版 WhatCable.zip，解压后拖到 /Applications。应用已签名并公证，不会触发 Gatekeeper 警告。

Homebrew 安装：

brew tap darrylmorley/whatcable
brew install --cask whatcable

Homebrew 安装还会自动将 whatcable CLI 工具链接到 PATH 中。

系统要求：macOS 14 (Sonoma) 或更高版本，仅支持 Apple Silicon（Intel Mac 的 USB-C 端口由 Thunderbolt 3 控制器驱动，不暴露 WhatCable 所需的 USB-PD 状态和线缆 E-Marker 数据）。

CLI 模式

除了菜单栏应用，WhatCable 还附带一个命令行工具，由相同的诊断引擎驱动：

whatcable                   # 每个端口的人类可读摘要
whatcable --json            # 结构化 JSON，可 pipe 到 jq
whatcable --watch           # 实时监控线缆插拔（Ctrl+C 退出）
whatcable --raw             # 包含底层 IOKit 属性

为什么需要这个工具

USB-C 是一个极其混乱的标准。同一接口形状的线缆可能意味着完全不同的规格：

• USB 2.0：仅支持充电和数据传输（低速），通常只有 60W
• USB 3.2 Gen 2：10Gbps 数据传输，最高 100W
• USB4：40Gbps，支持视频和高速数据
• Thunderbolt 4：40Gbps，兼具视频和数据
• 240W 线缆：最新的 EPR（扩展功率范围）线缆，可支持游戏本充电

问题在于，你完全没法靠外观判断。苹果官方线、拼多多 9.9 包邮线、Anker 快充线——从金属头到编织线身，越来越难以分辨。

WhatCable 解决了这个痛点。它利用 macOS 自带的 IOKit 框架读取 USB-C 控制器数据，不需要额外硬件，不需要注册账号，所有数据本地处理，不上传任何信息。

开源与隐私

WhatCable 是 MIT 协议的开源项目，代码托管在 GitHub。截至 2026 年 5 月，已获得 3400+ Star。

应用已签名并经过 Apple 公证，完全离线工作，不收集任何用户数据。对于注重隐私的开发者来说，这是一个非常可靠的选择。

适合谁

如果你有以下情况，WhatCable 会很实用：

• 有多根 USB-C 线缆且经常搞混 —— 插上去就能看到线缆的真实能力
• 发现充电变慢了想排查原因 —— 诊断功能会告诉你瓶颈在充电器、线缆还是设备
• 不确定手头的线缆是否支持视频输出 —— 一看便知
• 担心买到假冒伪劣线缆 —— 可信度信号可以识别异常 E-Marker

WhatCable 不解决线缆标识的问题（你仍然需要自己给线缆贴标签），但它至少让你在插上去的那一刻知道————这根线到底值不值得信赖。