如何避免pynput键盘监听中按键触发的无限循环问题

问题原因 #

你遇到的无限循环是因为用keyboard.Controller模拟按下q时，会被同一个Listener监听到，进而再次触发three_q()函数，形成循环。原代码中的pressing标志因为事件触发的异步性，无法完全阻断模拟按键的监听回调。

修复方案 #

核心思路是设置专门的标志，标记当前是否正在执行模拟按键操作，当监听到的按键是模拟产生时，直接跳过处理逻辑。

修改后的代码如下：

from pynput import keyboard

# 标记是否正在执行模拟按键，避免循环
is_simulating = False
controller = keyboard.Controller()  # 提前初始化控制器，避免重复创建

def tap(key):
    global is_simulating
    is_simulating = True
    controller.press(key)
    controller.release(key)
    is_simulating = False

def three_q():
    tap("q")
    tap("q")
    tap("q")

def on_press(key):
    global is_simulating
    # 如果是模拟的按键，直接跳过
    if is_simulating:
        return
    try:
        key_char = key.char
        if key_char == "q":
            three_q()
    except AttributeError:
        # 处理非字符按键（如功能键），直接跳过
        pass

def on_release(key):
    if key == keyboard.Key.esc:
        # 按下ESC停止监听
        return False

with keyboard.Listener(on_press=on_press, on_release=on_release) as listener:
    listener.join()

关键改进点 #

• 提前初始化控制器：避免每次调用tap()时重复创建keyboard.Controller实例，提升运行效率。
• is_simulating精准标记：在模拟按键的前后设置/重置标志，确保监听到模拟产生的q按键时直接跳过处理，从根源阻断循环。
• 简化逻辑：移除原有的pressing标志，用更精准的模拟状态标记替代，避免异步事件导致的标志状态混乱。

额外优化建议 #

如果需要只保留模拟的3个q（不保留手动按下的第一个q），可以在on_press中阻止原生按键事件的传递，修改后的on_press函数如下：

def on_press(key):
    global is_simulating
    if is_simulating:
        return
    try:
        key_char = key.char
        if key_char == "q":
            three_q()
            return False  # 返回False阻止原生按键事件，手动按下的q不会被输入
    except AttributeError:
        pass

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