Matplotlib单次点击触发Picker事件处理器多次调用问题排查

1. 单次点击触发多次事件的原因 #

你遇到的单次点击触发多次pick事件，核心原因是事件处理器被重复绑定：

• 如果你的绘图代码被多次执行（比如Jupyter单元格重复运行、函数多次调用），每次执行时都调用了canvas.mpl_connect('pick_event', ...)绑定处理器，但没有先断开之前的绑定，就会导致多个处理器实例同时监听pick事件。单次点击会触发所有已绑定的处理器，从而产生多次日志输出。

2. 第二次触发时匹配不到Artist的原因 #

结合日志里两次打印的Circle描述完全一致但第二次找不到的现象，问题出在不同处理器实例持有的artists字典不一致：

• 每次运行绘图代码时，你会重新创建Circle对象和对应的artists字典。旧的处理器实例绑定的是旧版本的artists字典（里面的Circle是之前创建的对象），而新的处理器绑定的是新的字典。当你点击新创建的Circle时：
  • 新处理器能在自己持有的新字典中匹配到该Circle，正常执行并输出done；
  • 旧处理器持有的字典里是旧的Circle对象，当前点击的新Circle不在其中，所以输出artist not found。

额外验证点 #

你可以在绑定事件时记录处理器的ID，或者打印artists字典的内存地址，就能看到每次绑定的处理器对应不同的字典实例：

# 绑定事件时保存连接ID，方便后续断开
cid = canvas.mpl_connect('pick_event', lambda evt: on_pick(evt, artists))
print(f"绑定的事件ID: {cid}, artists字典地址: {id(artists)}")

解决建议 #

1. 避免重复绑定事件：每次绑定前先断开之前的连接（如果有）：

   # 全局保存事件ID，初始为None
   global cid
   if cid is not None:
       canvas.mpl_disconnect(cid)
   cid = canvas.mpl_connect('pick_event', lambda evt: on_pick(evt, artists))
   

2. 确保artists字典的一致性：如果需要动态更新Circle，要么更新现有Circle的属性而非重新创建，要么确保所有处理器都能访问到最新的artists字典（比如用全局变量或类属性存储）。
3. 清理旧注释：每次创建新注释前，可以清除轴上已有的注释，避免界面混乱：

   # 清除轴上所有注释
   for ann in artist.axes.annotations:
       ann.remove()
   # 再创建新注释
   a = plt.annotate(f"{artists[artist].getX()}", xy=(x,y), xycoords='data')
   

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