银河麒麟系统下外接机械键盘灯不亮且按键无响应，说明设备未被内核正确枚举或输入子系统通信中断；需先用sudo evtest确认内核是否识别，再重载usbhid驱动、禁用laptop-mode-tools对usbhid的自动挂起，并校准键盘布局及启用LED支持。
银河麒麟系统下外接机械键盘灯不亮且按键无响应，说明设备未被内核正确枚举或输入子系统通信中断，不是单纯背光开关问题，而是从硬件识别到X11/Wayland层的全链路失效；需先确认是否进入内核事件流，再逐级排查驱动、电源管理与布局映射。
确认键盘是否被内核识别
打开终端，执行 sudo evtest → 按提示选择你的外接键盘（名称通常含“Logitech”“Dell”“Mechanical”或“Keyboard”，对应 /dev/input/eventX）→ 按下任意键。
若屏幕完全无输出，说明内核未捕获任何扫描码，问题在USB物理层或HID驱动加载失败；若能打印出 scancode 和 keycode，则问题在上层图形环境或输入法配置。
【关键提醒】必须用 sudo 执行 evtest，普通用户权限无法读取原始输入事件，会直接报错退出。
重载 USB HID 驱动强制刷新通信
这一步解决因雷电转接器固件异常、USB集线器供电不稳或系统休眠唤醒后驱动卡死导致的设备静默。
执行 lsmod | grep usbhid，确认模块已加载（有输出才继续）→ 运行 sudo modprobe -r usbhid（键盘会瞬间失联，属正常现象）→ 等待 1.5 秒 → 立即执行 sudo modprobe usbhid → 测试按键是否有响应、LED是否亮起。
若恢复，说明是 usbhid 模块状态僵死；为避免反复手动操作，新建配置文件：sudo nano /etc/modprobe.d/usbhid-fix.conf，写入一行：options usbhid ignoreled=0，保存退出。该参数可屏蔽部分机械键盘LED控制指令对HID协议的干扰。
禁用 laptop-mode-tools 对 usbhid 的 runtime suspend
这是银河麒麟桌面版（尤其预装于国产笔记本）最隐蔽的元凶：它默认对 usbhid 设备启用自动挂起，导致键盘处于低功耗休眠态，按键触发时无法及时唤醒，表现为“插上没反应”或“唤醒后全键失效”。
第一步：检查是否启用 → 执行 cat /proc/sys/vm/laptop_mode，输出非 0 即已开启；
第二步：确认工具存在 → dpkg -l | grep laptop-mode-tools，若无输出则跳过后续；
第三步：编辑黑名单配置 → sudo nano /etc/laptop-mode/conf.d/runtime-pm.conf，找到 AUTOSUSPEND_RUNTIME_DEVID_BLACKLIST= 行，改为：AUTOSUSPEND_RUNTIME_DEVID_BLACKLIST="usbhid usb-storage"；
第四步：重启服务 → sudo systemctl restart laptop-mode。
校准键盘布局与启用背光支持
方法一：命令行快速启用基础背光（适用于多数带LED控制的机械键盘）
执行 sudo apt install keyboard-configuration → 运行 sudo dpkg-reconfigure keyboard-configuration → 在交互界面中选择你的键盘型号（如“Generic 105-key PC”）、布局（如“Chinese”），最后确保勾选“Enable keyboard LED support”。
方法二：手动触发LED控制接口
执行 echo 1 | sudo tee /sys/class/leds/*::kbd/brightness 2>/dev/null，该命令尝试向所有已注册的键盘LED设备写入亮度值1；若提示“No such file or directory”，说明内核未暴露LED类设备节点，需回退至驱动重载步骤。
方法三：图形界面验证（仅限Wayland会话）
打开“控制中心”→“键盘”→“高级设置”，检查“键盘背光”开关是否可用；若灰显，说明当前会话未加载LED sysfs接口，此时应切换至X11会话重试（登录界面右下角选择“GNOME on Xorg”）。
