Python Mouse Listener报错求助：NotImplementedError及TypeError异常排查

原始代码（存在语法错误） #

import timeimport threading
from pynput.mouse import Listener

def clicker(x,y,button,pressed):print("a")
with Listener(on_click=clicker) as listener:listener.join()

报错信息 #

第一个异常 #

Unhandled exception in listener callback
Traceback (most recent call last):
File "C:\Users\Arda\PycharmProjects\pythonProject.venv\Lib\site-packages\pynput\_util\win32.py", line 386, in _handler
converted = self._convert(code, msg, lpdata)
File "C:\Users\Arda\PycharmProjects\pythonProject.venv\Lib\site-packages\pynput\_util\win32.py", line 401, in _convert
raise NotImplementedError()
NotImplementedError

第二个异常 #

Traceback (most recent call last):
File "C:\Users\Arda\PycharmProjects\pythonProject.venv\Lib\site-packages\pynput\_util\__init__.py", line 229, in inner
return f(self, *args, **kwargs)
File "C:\Users\Arda\PycharmProjects\pythonProject.venv\Lib\site-packages\pynput\_util\win32.py", line 390, in _handler
self._handle(code, msg, lpdata)
~~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^
TypeError: '_thread._ThreadHandle' object is not callable

错误原因及解决办法 #

1. 代码语法错误
   原始代码存在多处语法问题：

   • 多个import语句写在同一行（import timeimport threading）
   • 函数定义与内部执行语句未换行（def clicker(...):print("a")）
   • with代码块内的语句未单独换行
     这些语法问题会导致Python解析异常，进而触发后续运行时错误。

2. pynput环境兼容问题
   报错中的NotImplementedError和TypeError常见于Windows环境下pynput版本不兼容，或线程处理冲突导致的钩子注册失败。

3. 修正后的代码（实现左键点击输出）

   import threading
   import time
   from pynput.mouse import Listener, Button
   
   def clicker(x, y, button, pressed):
       # 判断是否为左键按下事件
       if pressed and button == Button.left:
           print("左键点击触发，输出指定内容")
   
   with Listener(on_click=clicker) as listener:
       listener.join()
   

4. 额外解决步骤

   • 升级或重新安装pynput：执行 pip install --upgrade pynput
   • Windows系统下，尝试以管理员权限运行Python脚本，避免权限不足导致的钩子注册失败
   • 关闭其他监控类软件，避免鼠标钩子资源冲突

内容的提问来源于stack exchange，提问作者Arda Karakaş