使用PyQt5与pynput阻止特定按键传递至前台应用的问题

我需要检测特定按键的按下操作，并阻止这些按键传递至前台应用。不想使用pywin32、pyHook这类难以构建的库，因此选择pynput。但无论如何尝试，虽然空格键能被拦截，但整个Qt应用会挂起，甚至出现段错误。

根据pynput文档及相关帖子，应使用suppress=True，但这会导致应用挂起。原代码如下：

import sys
from PyQt5.QtWidgets import QApplication, QDialog
from PyQt5.QtCore import QThread, pyqtSignal, pyqtSlot
from pynput.keyboard import Listener, Key


class KeyListenerWorker(QThread):
    keyPressed = pyqtSignal(str, bool)  

    def __init__(self, configured_keys=None):
        super(KeyListenerWorker, self).__init__()
        self.configured_keys = configured_keys or []
        self.listener = None

    def run(self):
        with Listener(on_press=self.on_press, on_release=self.on_release) as self.listener:
            self.listener.join()

    def on_press(self, key):
        key_description = self.get_key_description(key)
        self.keyPressed.emit(key_description, True)
        # 如果是配置好的按键则阻止传递
        return False if key_description in self.configured_keys else True

    def on_release(self, key):
        key_description = self.get_key_description(key)
        self.keyPressed.emit(key_description, False)
        # 如果是配置好的按键则阻止传递
        return False if key_description in self.configured_keys else True

    def get_key_description(self, key):
        if hasattr(key, 'char') and key.char:
            return key.char
        return str(key)

    def stop(self):
        if self.listener:
            self.listener.stop()

class MainWindow(QDialog):
    def __init__(self, configured_keys):
        super().__init__()
        self.setWindowTitle("按键监听运行中")
        self.resize(300, 100)

        self.listener_thread = KeyListenerWorker(configured_keys=configured_keys)
        self.listener_thread.keyPressed.connect(self.handle_key_event)
        self.listener_thread.start()

    def handle_key_event(self, key, is_press):
        action = "按下" if is_press else "释放"
        print(f"{action}: {key}")

    def closeEvent(self, event):
        self.listener_thread.stop()
        self.listener_thread.wait()
        super().closeEvent(event)

if __name__ == "__main__":
    app = QApplication(sys.argv)
    configured_keys = [str(Key.space)]  # 配置为监听空格键
    mainWindow = MainWindow(configured_keys)
    mainWindow.show()
    sys.exit(app.exec_())

class KeyListenerWorker(QThread):
    keyPressed = pyqtSignal(str, bool)  

    def __init__(self, configured_keys=None):
        super(KeyListenerWorker, self).__init__()
        self.configured_keys = configured_keys or []
        self.listener = None

    def run(self):
        # 设置suppress=False：启动时不拦截任何按键，由回调函数决定是否拦截
        with Listener(on_press=self.on_press, on_release=self.on_release, suppress=False) as self.listener:
            self.listener.join()

    def on_press(self, key):
        key_description = self.get_key_description(key)
        self.keyPressed.emit(key_description, True)
        # 如果是配置好的按键则拦截，返回False表示拦截，True表示放行
        return not (key_description in self.configured_keys)

    def on_release(self, key):
        key_description = self.get_key_description(key)
        self.keyPressed.emit(key_description, False)
        # 如果是配置好的按键则拦截
        return not (key_description in self.configured_keys)

    def get_key_description(self, key):
        if hasattr(key, 'char') and key.char:
            return key.char
        return str(key)

    def stop(self):
        if self.listener:
            self.listener.stop()

解决思路 #

原问题核心在于Listener初始化时的全局拦截设置与Qt主线程产生阻塞冲突。修改后：

• 初始化Listener时明确设置suppress=False，让所有按键默认放行，避免全局拦截导致的线程阻塞
• 在on_press和on_release回调中，通过返回值精确控制是否拦截特定按键：返回False拦截目标按键，返回True放行其他按键，既实现了需求功能，又避免了应用挂起问题

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