在使用 `keyboard` 模块时，如果尝试在类的 `__init__` 方法中定义 `keyboard.on_press` 回调函数，但发现回调未生效，这通常是由于作用域、绑定或事件监听器生命周期管理的问题。以下是一些可能的原因和解决方案： ### 1. 正确绑定回调函数 确保回调函数被正确绑定到 `keyboard.on_press`。当在类的方法中定义回调时，必须将方法绑定为回调函数。可以使用如下方式： ```python from pynput import keyboard class KeyLogger: def __init__(self): self.keys = [] # 绑定回调函数 self.listener = keyboard.Listener( on_press=self.on_press, on_release=self.on_release ) self.listener.start() def on_press(self, key): print(f'{key} pressed') def on_release(self, key): print(f'{key} released') if str(key) == 'Key.esc': return False ``` 上述代码创建了一个 `Listener` 实例，并将其启动以开始监听键盘事件。确保在 `__init__` 中启动监听器，否则回调不会生效。 ### 2. 避免作用域问题 如果使用 `keyboard.on_press` 直接注册回调（而不是通过 `pynput.keyboard.Listener`），需要确保回调函数的作用域正确。例如： ```python import keyboard class KeyHandler: def __init__(self): # 注册回调函数 keyboard.on_press(self.on_key_event) def on_key_event(self, event): print(f'Key pressed: {event.name}') # 实例化类并保持程序运行 handler = KeyHandler() keyboard.wait('esc') # 等待Esc键退出 ``` 在此示例中，`keyboard.on_press` 被用于注册一个实例方法作为回调。需要注意的是，`keyboard` 模块的某些功能可能要求以管理员权限运行，否则可能导致无法捕获事件 [^4]。 ### 3. 使用全局变量或单例模式管理监听器 有时，监听器对象可能在类实例化后被提前销毁，导致回调无效。可以通过将监听器设置为类属性或使用单例模式来解决此问题： ```python from pynput import keyboard class KeyLogger: listener = None def __init__(self): self.keys = [] if KeyLogger.listener is None: KeyLogger.listener = keyboard.Listener( on_press=self.on_press, on_release=self.on_release ) KeyLogger.listener.start() def on_press(self, key): print(f'{key} pressed') def on_release(self, key): print(f'{key} released') if str(key) == 'Key.esc': return False ``` ### 4. 检查是否与其他监听器冲突 如果有多个监听器同时运行，可能会导致事件被其他监听器拦截或处理失败。确保没有重复初始化监听器，并在适当的时候停止监听器。 ### 5. 确保主线程不退出 Python 的事件监听器通常依赖于主线程持续运行。如果主线程提前结束，监听器也会终止。可以在主程序中添加阻塞逻辑以保持程序运行： ```python if __name__ == '__main__': logger = KeyLogger() input("按 Enter 键退出...\n") # 保持程序运行 ``` 或者使用 `keyboard.wait()`： ```python keyboard.wait('esc') # 等待 Esc 键退出 ``` ---