Win10下Python(Kivy)非聚焦状态键盘检测：替代Pynput方案

一、优化Pynput的长按延迟问题 #

• 提升监听线程优先级：非聚焦状态下系统会降低后台应用的线程调度优先级，导致Pynput的键盘监听线程响应滞后。可以手动提升线程优先级，示例代码：

  import threading
  from pynput import keyboard
  
  def on_press(key):
      pass
  
  def on_release(key):
      pass
  
  listener = keyboard.Listener(on_press=on_press, on_release=on_release)
  listener.start()
  # 提升线程至最高优先级（仅Windows系统有效）
  listener.thread.setPriority(threading.Thread.MAX_PRIORITY)
  

• 避免阻塞监听回调：不要在on_press/on_release中执行耗时操作（比如同步更新Kivy UI），这类操作会直接阻塞监听线程。改用Kivy的异步调度处理：

  from kivy.clock import Clock
  
  def on_release(key):
      # 将业务逻辑放入异步队列，不阻塞监听线程
      Clock.schedule_once(lambda dt: handle_key_release(key), 0)
  

• 排查系统钩子冲突：Win10下的输入法、杀毒软件、游戏辅助工具可能抢占键盘钩子资源，暂时关闭这类软件测试是否解决延迟问题。
• 切换钩子模式：尝试强制使用Windows原生低级键盘钩子（WH_KEYBOARD_LL），部分场景下比Pynput默认的高层钩子更稳定，可通过pywin32直接实现该钩子（见替代方案）。

二、Win10下的替代模块 #

• keyboard模块：轻量级全局键盘监听库，API简洁，对Win10全局键盘事件支持良好，非聚焦状态下响应稳定。使用示例：

  import keyboard
  
  def on_key_event(e):
      if e.event_type == 'down':
          # 处理按键按下逻辑
          pass
      elif e.event_type == 'up':
          # 处理按键释放逻辑
          pass
  
  keyboard.hook(on_key_event)
  keyboard.wait()
  

  注意：需以管理员权限运行脚本，否则可能无法捕获全局事件。
• pywin32（直接调用Windows API）：完全可控的方案，通过SetWindowsHookEx设置全局低级键盘钩子，避免第三方库封装带来的延迟。核心示例代码：

  import win32api
  import win32con
  import win32gui
  
  def keyboard_hook(nCode, wParam, lParam):
      if nCode >= 0:
          key_code = lParam[0]
          if wParam == win32con.WM_KEYDOWN:
              print(f"按键按下: {key_code}")
          elif wParam == win32con.WM_KEYUP:
              print(f"按键释放: {key_code}")
      return win32api.CallNextHookEx(None, nCode, wParam, lParam)
  
  # 设置全局低级键盘钩子
  hook_id = win32api.SetWindowsHookEx(win32con.WH_KEYBOARD_LL, keyboard_hook, win32api.GetModuleHandle(None), 0)
  # 维持消息循环以保持钩子运行
  try:
      msg = win32gui.GetMessage(None, 0, 0)
      win32gui.TranslateMessage(msg)
      win32gui.DispatchMessage(msg)
  finally:
      win32api.UnhookWindowsHookEx(hook_id)
  

  该方式需处理Windows消息循环，适合对性能要求较高的场景，几乎无延迟。

内容的提问来源于stack exchange，提问作者Ten Kho