Linux需先libusb_detach_kernel_driver再open；Windows需WinUSB驱动并用WinUsb_GetDescriptor；macOS需entitlement和IOUSBInterface接口；跨平台须动态分配缓冲区重试。
Linux 下用 libusb 获取 USB 设备描述符：绕过权限和内核驱动冲突
普通用户直接调用 libusb_open() 会失败，常见错误是 LIBUSB_ERROR_ACCESS 或设备被内核驱动（如 usbhid、uas）占用。必须先解除内核绑定，再设置 udev 规则授予权限。
- 用
lsusb -t查看设备是否被内核驱动接管（如显示driver=usbhid） - 运行
sudo sh -c 'echo 0000:00:14.0 > /sys/bus/pci/drivers/xhci_hcd/unbind'（替换为对应 xHCI 控制器 PCI 地址）可临时禁用控制器，但更稳妥的是用libusb_detach_kernel_driver() - 在调用
libusb_open()前，对目标设备调用libusb_detach_kernel_driver(handle, 0)；若返回LIBUSB_ERROR_NOT_FOUND，说明没被占用，可忽略 - udev 规则示例（
/etc/udev/rules.d/99-usb-raw.rules）：SUBSYSTEM=="usb", ATTR{idVendor}=="0x1234", MODE="0664", GROUP="plugdev"，然后执行sudo udevadm control --reload-rules && sudo udevadm trigger
Windows 上用 SetupAPI + WinUSB 绕过 HID/Storage 类驱动限制
Windows 默认把 HID、Mass Storage 等设备挂给系统类驱动，导致 SetupDiGetDeviceRegistryProperty() 只能读到通用属性，拿不到完整描述符。必须用 WinUSB 驱动接管设备，再通过 WinUsb_GetDescriptor() 获取。
- 先用
SetupDiEnumDeviceInterfaces()枚举接口，注意传入GUID_DEVINTERFACE_WINUSB而非GUID_DEVINTERFACE_USB_DEVICE，否则无法匹配已安装 WinUSB 的设备 - 调用
SetupDiGetDeviceInterfaceDetail()获取设备路径后，用CreateFile()打开时必须加FILE_FLAG_OVERLAPPED标志，否则WinUsb_Initialize()会失败 -
WinUsb_GetDescriptor()的DescriptorType参数填USB_DEVICE_DESCRIPTOR_TYPE（0x01）或USB_CONFIGURATION_DESCRIPTOR_TYPE（0x02），不能填错——填 0x00 会返回ERROR_INVALID_PARAMETER - 若设备未安装 WinUSB 驱动，需用
zadig.exe或 INF 文件手动替换，不能依赖 Plug and Play 自动加载
macOS 上用 IOKit 获取描述符：避开 sandbox 和 entitlements 陷阱
macOS Catalina 及以后，默认禁止非沙盒进程访问 USB 设备，即使有 root 权限也会收到 kIOReturnNotPermitted。必须启用特定 entitlement 并链接 IOKit 框架。
- Xcode 工程中需开启
Hardened Runtime，并在Signing & Capabilities → App Sandbox → Hardware → USB打勾；同时在Entitlements文件里显式添加com.apple.security.device.usb=true - 不要用
IOServiceGetMatchingServices()直接匹配IOUSBDevice类，它返回的句柄不支持读取原始描述符；应匹配IOUSBInterface，再用IOCreatePlugInInterfaceForService()创建IOUSBInterfaceInterface实例 - 调用
GetDeviceDescriptor()方法前，必须先调用USBInterfaceOpen()，否则返回kIOUSBPendingResult；且该方法是同步阻塞的，别在主线程调用 - 获取到的
USBDeviceDescriptor结构体字段是小端序，bcdUSB、idVendor等需用CFByteOrderSwapShort()转换，否则值看起来像乱码
跨平台读取时 descriptor 缓冲区大小和重试逻辑怎么设
USB 描述符长度不是固定的：设备描述符固定 18 字节，但配置描述符含可变长接口/端点子描述符，总长常超 64 字节。一次 libusb_get_descriptor() 或 WinUsb_GetDescriptor() 失败很常见，不能只靠单次调用。
- 首次请求配置描述符时，先用小缓冲区（如 16 字节）读前 4 字节，解析出实际长度
wTotalLength，再分配对应大小缓冲区重试 - libusb 中若
libusb_get_descriptor()返回负值，检查是否为LIBUSB_ERROR_OVERFLOW（表示缓冲区太小），而不是直接报错退出 - Windows 上
WinUsb_GetDescriptor()若返回ERROR_INSUFFICIENT_BUFFER，需用GetLastError()获取真实所需字节数，而非硬编码 256 - macOS 的
GetConfigurationDescriptor()不返回长度，必须先调用GetNumberOfConfigurations()，再逐个索引请求，索引越界会静默失败
实际操作中最容易卡住的，是 Linux 下忘记 detach kernel driver 就 open 设备，或 Windows 下没装 WinUSB 驱动就硬调接口函数——这两个点一旦出错，后续所有描述符读取都会静默失败或返回默认值，很难定位。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
