
本文介绍如何使用python独占捕获指定usb键盘的按键事件,同时阻止该键盘在操作系统层面的正常输入行为,实现仅向python程序传递原始按键数据的专用监听方案。
在嵌入式控制、工业HID设备交互或安全终端场景中,常需让某台物理USB键盘“仅对Python程序可见”——即按键不触发系统输入(如文本框打字、快捷键响应),但能被Python实时捕获并自定义处理。这本质上是一个输入劫持(input hijacking)+ 键盘独占(device isolation) 问题,需分两步实现:1)拦截并屏蔽系统级键盘事件;2)底层读取原始HID报告并解析为按键信号。
⚠️ 注意:keyboard.block_key() + pynput.Listener 的组合(如原答案所示)存在根本性缺陷:
- keyboard.block_key() 仅作用于Windows虚拟键码,无法可靠屏蔽所有USB HID键盘事件,尤其在Linux/macOS下完全不可用;
- pynput 默认监听的是系统已分发后的事件,此时按键早已进入系统输入流,屏蔽为时已晚;
- 上述代码会全局屏蔽所有键(range(150)),且未指定设备,无法做到“仅针对某一台USB键盘”。
✅ 正确方案是绕过系统输入栈,直接读取USB HID原始设备节点,推荐使用 evdev(Linux)或 pywin32 + 原生HID API(Windows)方案。以下以 Linux(主流开发/工控环境) 为例提供完整可运行方案:
✅ 推荐方案:使用 evdev 直接访问USB键盘设备节点
pip install evdev
#!/usr/bin/env python3
import evdev
from evdev import InputDevice, UInput, ecodes
import os
# Step 1: 列出所有输入设备,找到目标USB键盘(通过名称或物理路径识别)
def find_usb_keyboard(keyword="USB Keyboard"):
devices = [InputDevice(path) for path in evdev.list_devices()]
for dev in devices:
if keyword.lower() in dev.name.lower() or "usb" in dev.phys.lower():
print(f"✅ 找到目标键盘: {dev.name} @ {dev.path}")
return dev
raise RuntimeError("未找到匹配的USB键盘,请检查设备连接及名称")
# Step 2: 创建虚拟输入设备(可选:用于后续转发处理后的事件)
# ui = UInput() # 若需将处理后事件发回系统,可启用此行
# Step 3: 独占打开设备(EXCLUSIVE模式阻止其他进程读取)
dev = find_usb_keyboard("Logitech USB Keyboard") # 替换为你的键盘实际名称
dev.grab() # ⚠️ 关键!独占设备,系统和其他程序将无法接收其事件
print("? 键盘已独占。开始监听...(按 Ctrl+C 退出)")
try:
for event in dev.read_loop(): # 持续监听原始事件
if event.type == ecodes.EV_KEY and event.value == 1: # 按下事件
key_name = ecodes.KEY[event.code] if event.code in ecodes.KEY else f"KEY_{event.code}"
print(f"[捕获] {key_name} (code={event.code})")
# ✅ 在此处添加你的业务逻辑:解密、协议解析、触发动作等
# 示例:将F13映射为“紧急停止”
if event.code == ecodes.KEY_F13:
print("⚠️ 执行紧急停止协议...")
# your_custom_logic()
except KeyboardInterrupt:
print("\n? 已退出监听")
finally:
dev.ungrab() # 释放设备? 关键要点说明:
- dev.grab() 是核心:它通过Linux内核EVIOCGRAB ioctl调用锁定设备文件(如/dev/input/event2),确保只有当前Python进程能读取该设备事件,系统X11/Wayland输入服务自动失效;
- 精准设备定位:通过 dev.name(如 "Logitech USB Keyboard")或 dev.phys(物理总线路径,如 "usb-0000:00:14.0-1/input0")精确绑定,避免影响其他键盘;
- 无需root权限:只要当前用户属于input组(sudo usermod -aG input $USER),即可访问/dev/input/event*;
-
跨平台替代方案:
- Windows:使用 pywin32 + RegisterRawInputDevices + GetRawInputData 实现类似独占;
- macOS:需结合IOKit框架(复杂度高),推荐使用第三方库 hidapi。
? 原答案为何不推荐?
- keyboard.block_key() 本质是模拟按键屏蔽,易被绕过且无设备粒度控制;
- pynput 是高层抽象,依赖系统事件分发,无法实现真正的“输入隔离”;
- 全局屏蔽 range(150) 键码会破坏功能键(如音量、亮度),且无法区分多键盘。
? 提示:部署前请先用 evtest 命令验证目标设备路径与事件行为:sudo apt install evtest && sudo evtest → 选择对应USB键盘设备 → 观察按键输出是否纯净。
通过 evdev.grab() 方案,你获得的是真正意义上的硬件级独占访问权——键盘对系统“隐身”,却对Python“透明”,完美满足工业控制、KIOSK终端、安全审计等严苛场景需求。
立即学习“Python免费学习笔记(深入)”;










