如何修复 macOS Tahoe 26 上的 USB 端口,Windows与macOS系统均可使用

视频教程

前言

前两天写过一篇macOS Tahoe (26.0) 及更高版本上定制 USB 端口的教程,链接:https://imacos.top/2025/06/18/macos-tahoe-26-usb/
但是有部分用户表示还是比较复杂了,本文的教程适用于你在macOS 26以前的版本中已经定制USB端口,或在windows下已经定制过的情况,如果你还没地址过,也可以看我之前在Windows下地址的教程https://imacos.top/2022/08/22/windows-usb-macos-bigsur-11-3-usbtoolbox/

注意:本教程是在你已经定制了USB的端口下操作的,如果没定制过,可以按照上述的两个教程地址,本教程介绍如何在 macOS Tahoe (26.0) 及更高版本上修复 USB 端口。按照本教程操作，您将能够修复打算使用 macOS Tahoe 的系统上的 USB 端口，并且确保 macOS Sequoia 或更早版本上的端口仍然可用。本指南也适用于希望使用 OCLP 在不受支持的 Mac 上运行 macOS Tahoe 的用户。

概述

最近，苹果公司于 6 月 9 日的 WWDC25 大会上发布了 macOS Tahoe (26.0)，这是 2025 年最受期待的版本之一。一如既往，如果您是苹果用户，您可能对苹果公司在新版本中不断改进、每年都保持一致的做法深有体会。虽然出乎意料，但苹果公司在 macOS Tahoe 26 中对其 USB 堆栈进行了更改，导致 macOS Tahoe 上的 USB 端口无法正常工作。这是因为 macOS Tahoe 使用了一个新密钥来识别 USB 端口，这在 IOReg 和系统报告 > USB 中也有体现。由于 USB 端口无法正常工作，安装程序会在通过 USB 安装程序启动时停止运行并显示著名的“仍在等待设备”错误。幸运的是，您无需从头开始重新映射 USB 端口，只需调整这些新密钥来识别 USB 端口，同时保留现有的映射驱动即可。

为了简化，以下是端口标识的新旧键：
旧： UsbConnector，port
新： usb-port-type，usb-port-number

如果您仍然不清楚，让我们以更简单的方式理解。UsbConnector被键替换usb-port-type，port被替换usb-port-number。其中，UsbConnector表示连接器类型，port表示端口号。同样，usb-port-type表示连接器类型，usb-port-number表示端口号，这些我们已经理解了。

支持情况

本指南支持由 Hackintool 生成的 USBPorts.kext 和由 @Corpnewt USBMap 工具生成的 USBMap.kext。

修复 macOS Tahoe

按照以下步骤修复您的 USB 端口，而无需再次映射。

1. 导航到ESP/EFI/OC/Kexts目录。
2. 备份现有的USBPorts.kext或USBMap.kext。
3 .右键单击 USBPorts.kext或USBMap.kext，然后选择“显示包内容”：

4.使用 Xcode 或任何 Plist 编辑器从Contents目录打开Info.plist(Windows下也有Plist 编辑,Xplist1.2.47跨平台的编辑器整理到本文的下载地址中了)。

5. 找到IOKitPersonalities并展开ports。IOProvideMergeProperties您应该看到类似以下内容：

6.在映射的 kext 中定义的每个端口（HSXX 和 SSXX）中创建两个名为usb-port number 和 usb-port-type的新子项，并将的Class（值类型）设置为Datausb-port-number,Numberusb-port-type

7. 将该值与现有配置的值进行匹配,UsbConnector匹配usb-port-type,port匹配usb-port-number,例如，usb-port-numberHS03对应UsbConnector设置为3(USB 3.0) ,port值03000000同理，将值更改为新的密钥以匹配您的密钥。

您还可以考虑重新排列，以获得更好的视觉效果并避免任何可能的混淆。