Python 中使用 keyboard 模块时多线程导致键盘监听冻结的解决方案

本文详解 keyboard 模块在多线程（尤其配合 asyncio）环境下调用 is_pressed()、read_event() 等函数时无响应、卡死的根本原因，并提供稳定替代方案——推荐使用 Windows 原生 msvcrt 模块实现非阻塞、可中断、线程安全的键盘输入检测。 本文详解 `keyboard` 模块在多线程（尤其配合 `asyncio`）环境下调用 `is_pressed()`、`read_event()` 等函数时无响应、卡死的根本原因，并提供稳定替代方案——推荐使用 windows 原生 `msvcrt` 模块实现非阻塞、可中断、线程安全的键盘输入检测。在 Python GUI 或后台服务类脚本中，常需同时运行异步任务（如网络连接）与实时键盘交互（如快捷键控制）。但许多开发者发现：一旦启动独立线程执行 asyncio.run()，原本正常工作的 keyboard.is_pressed() 突然“冻结”——既不返回 True/False，也无法被 Ctrl+C 中断，整个主线程陷入假死。根本原因在于：keyboard 模块底层依赖全局钩子（Windows 下为 SetWindowsHookEx）和专用监听线程，其事件循环与 asyncio 主循环或 threading 的调度存在资源竞争与消息泵冲突；更关键的是，keyboard 的 is_pressed() 是伪轮询——它内部会尝试同步读取钩子队列，但在多线程+异步混合场景下极易因锁竞争或消息丢失而永久阻塞。值得注意的是，keyboard.add_hotkey() 虽能绕过此问题（因其注册回调，不主动轮询），但它无法清空系统键盘缓冲区，导致按键残留——当程序退出或后续调用 input() 时，积压的按键会突然“爆发式”输入，破坏交互逻辑。同样，pynput 也存在缓冲区不可控问题。? 推荐方案：使用 msvcrt（仅限 Windows）实现轻量、可靠、无缓冲污染的键盘检测msvcrt 是 Python 标准库中专为 Windows 设计的底层 C 运行时接口，其 kbhit() 和 getch() 行为与 C 语言完全一致： msvcrt.kbhit()：立即返回布尔值，绝不阻塞，线程安全； msvcrt.getch()：仅在有按键时读取单字节（含功能键转义序列），自动消耗输入，不留缓冲； 完美兼容多线程与 asyncio —— 因其不依赖全局钩子，而是直接查询控制台输入缓冲区。以下为修复后的完整示例（已移除 keyboard 依赖，支持多线程 + 键盘实时响应）： Vozo Vozo是一款强大的AI视频编辑工具，可以帮助用户轻松重写、配音和编辑视频。