要分析 macOS 输入设备日志，需聚焦 com.apple.iokit、com.apple.HID、com.apple.CoreInput 等子系统及 HIDSystemState、AppleMultitouchDriver、WindowServer 等进程，用 log show 结合 predicate 精准筛选，并辅以 Console、log stream 和 system_profiler 验证。
要分析 macos 系统级输入设备（如键盘、触控板、鼠标、触控栏）的日志，核心是定位统一日志（unified logging）中与 i/o、hid、coreinput 相关的子系统和进程，并用 log show 精准提取。
识别关键子系统和进程标识
macOS 输入设备日志主要由以下组件生成：
- com.apple.iokit：I/O Kit 框架底层驱动事件，含 USB/Bluetooth 设备接入、断开、枚举失败等
- com.apple.HID：人机接口设备（HID）服务，记录触控板手势、键盘按键映射、Force Touch 压感等
- com.apple.CoreInput：高层输入事件分发，如点击、滚动、多指操作被系统识别为有效动作
- com.apple.driver.AppleUSBHost 和 com.apple.driver.AppleBluetoothHIDDriver：分别对应 USB 和蓝牙外设的驱动层日志
- 进程名常见有：
HIDSystemState（系统 HID 状态管理）、AppleMultitouchDriver（触控板/触控屏驱动）、WindowServer（接收并分发输入事件给前台 App）
常用 log show 命令组合
直接在终端中运行以下命令（建议先用 sudo 提权以获取完整权限日志）：
- 查看本次启动以来所有 HID 相关日志：
log show --predicate 'subsystem == "com.apple.HID"' --last boot - 筛选触控板异常（如“stuck”、“timeout”、“reset”）：
log show --predicate 'subsystem == "com.apple.HID" AND eventMessage contains[c] "stuck" OR eventMessage contains[c] "timeout"' --last 1h - 抓取键盘失灵时段的底层 USB 事件：
log show --predicate 'subsystem == "com.apple.iokit" AND eventMessage contains[c] "keyboard" AND (eventMessage contains[c] "fail" OR eventMessage contains[c] "disconnect")' --last 30m - 跟踪某次鼠标移动是否被 WindowServer 正确接收：
log show --predicate 'process == "WindowServer" AND eventMessage contains[c] "mouse" AND level >= 2' --last 5m（level >= 2表示 info 及以上级别）
配合时间窗口与导出做深度排查
输入问题往往发生在特定操作后几秒内，需结合精确时间或行为触发点：
- 若刚插上 USB 键盘就失灵，立即执行：
log show --start "$(date -v-2M '+%Y-%m-%d %H:%M:%S')" --predicate 'subsystem beginswith "com.apple.iokit"' | grep -i "keyboard\|usb" - 将最近一小时 HID 日志导出为文本便于全文搜索：
log show --predicate 'subsystem == "com.apple.HID"' --last 1h > ~/Desktop/hid_log.txt - 导出 JSON 格式方便用脚本解析（如统计某类错误出现频次）：
log show --predicate 'subsystem == "com.apple.HID"' --last 15m --style json > /tmp/hid.json
补充验证方式
单靠日志可能不够，建议同步检查：
- 打开“控制台”App → 左侧选本机 → 搜索栏输入
HID或IOHID，开启实时流观察插拔设备时的即时输出 - 使用
log stream实时监听（更灵敏）：log stream --predicate 'subsystem == "com.apple.HID" OR subsystem == "com.apple.iokit"' --info - 确认硬件是否被系统识别：
system_profiler SPUSBDataType | grep -A 5 -B 5 "Keyboard\|Trackpad"
