Python keyboard模块按键重复触发问题排查及替代模块咨询

AI 小北

2026-6-24

问题原因

keyboard.read_key()会捕获按键的**按下（keydown）和释放（keyup）**两个独立事件，每按一次箭头键，这个方法会被触发两次（分别对应按下和抬起动作），所以你会看到重复输出。

修复现有代码的方案

可以改用只响应按键按下动作的方法，或者通过事件监听明确指定只处理keydown事件：

方案1：使用`keyboard.wait()`

该方法仅在按键按下时返回一次，不会捕获释放事件：

import keyboard

while True:
    key = keyboard.wait()
    if key == 'left':
        print('left')
    elif key == 'right':
        print('right')
    elif key == 'up':
        print('up')
    elif key == 'down':
        print('down')
    elif key == 'q':
        print('quit')
        break

方案2：监听keydown事件

通过注册按键按下的回调函数，只处理按下动作：

import keyboard

def handle_key_press(event):
    if event.name == 'left':
        print('left')
    elif event.name == 'right':
        print('right')
    elif event.name == 'up':
        print('up')
    elif event.name == 'down':
        print('down')
    elif event.name == 'q':
        print('quit')
        keyboard.unhook_all()
        exit()

keyboard.on_press(handle_key_press)
keyboard.wait()

替代按键追踪模块

pynput：专注于输入设备监控与控制的模块，对键盘事件的区分非常清晰，默认不会重复触发。示例代码：

from pynput.keyboard import Key, Listener

def on_key_press(key):
    try:
        if key == Key.left:
            print('left')
        elif key == Key.right:
            print('right')
        elif key == Key.up:
            print('up')
        elif key == Key.down:
            print('down')
        elif key.char == 'q':
            print('quit')
            return False  # 停止监听
    except AttributeError:
        # 处理特殊按键（无char属性）的情况
        pass

with Listener(on_press=on_key_press) as listener:
    listener.join()