如何在Debian的Python3中使用keyboard库避免按键自动重复？

我之前在Debian上用keyboard库做按键监听时，也碰到过一模一样的问题——按住Shift、Ctrl或者普通字符键，都会不停触发KeyDownEvent，根本没法区分是第一次按下还是自动重复。试了几种方法，分享给你：

方法1：代码内追踪按键状态（推荐） #

这是最灵活的方案，完全在Python代码层面解决，不影响系统其他程序的键盘行为。核心思路是维护一个集合，记录当前处于按下状态的按键，只有当按键从“未按下”切换到“按下”时，才执行你的业务逻辑。

示例代码：

import keyboard

# 用集合存储当前已按下的按键，避免重复处理
pressed_keys = set()

def handle_key_down(event):
    key_name = event.name
    # 只有按键不在已按下集合里时，才处理第一次按下事件
    if key_name not in pressed_keys:
        pressed_keys.add(key_name)
        # 这里替换成你自己的业务逻辑
        print(f"检测到首次按下: {key_name}")

def handle_key_up(event):
    key_name = event.name
    # 按键松开时，从集合中移除，确保下次按下能被正确识别
    if key_name in pressed_keys:
        pressed_keys.remove(key_name)

# 绑定事件监听
keyboard.on_press(handle_key_down)
keyboard.on_release(handle_key_up)

# 保持程序运行，直到你手动终止
keyboard.wait()

这个方法对所有按键都有效，不管是普通字符键还是Shift、Alt这类修饰键，完美解决自动重复的问题。

方法2：系统级禁用键盘自动重复（全局生效） #

如果你希望整个Debian系统都禁用键盘自动重复（包括其他程序），可以用系统命令来设置：

针对X11桌面环境 #

打开终端执行：

# 禁用键盘自动重复
xset r off

# 若要恢复默认，执行：
xset r on

针对Wayland桌面环境（比如GNOME） #

执行：

# 禁用重复
gsettings set org.gnome.desktop.peripherals.keyboard repeat false

# 恢复默认
gsettings set org.gnome.desktop.peripherals.keyboard repeat true

这个方法的缺点是全局生效，会影响你在其他程序里的键盘输入（比如打字时按住字符键不会重复输出），所以如果只是你的Python程序需要这个功能，优先用方法1。

方法3：利用keyboard库的事件属性过滤（不推荐） #

keyboard库的事件对象有一个time属性，记录事件触发的时间戳。你可以记录每个按键上次触发的时间，当两次事件间隔小于系统的键盘重复延迟时，就忽略重复事件。不过这个方法不如状态追踪可靠，因为系统的重复延迟可能会变化，而且代码复杂度更高，所以不推荐。

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