Matplotlib散点图交互功能失效，hover与pick事件触发无响应

1. 后端配置排查 #

交互功能失效最常见的原因是matplotlib使用了非交互静态后端，跨系统复现的场景下该问题概率最高。

• 先运行下方代码确认当前后端：

import matplotlib
print(matplotlib.get_backend())

• 如果输出为agg、svg、pdf这类无GUI的静态后端，直接在所有matplotlib导入语句的最开头指定交互后端即可：

import matplotlib
matplotlib.use('TkAgg') # 也可替换为Qt5Agg、QtAgg等可用的交互后端
import matplotlib.pyplot as plt

• 缺少对应后端依赖的情况下安装对应包：
  • Windows/macOS：执行pip install pyqt5 tk
  • Fedora：执行sudo dnf install python3-matplotlib-qt5 python3-tkinter

2. 版本兼容问题排查 #

如果故障出现前你升级过matplotlib、numpy或GUI相关依赖包，大概率是版本兼容问题：

• 回滚到3.5.x系列稳定版即可解决绝大多数兼容问题：

pip install matplotlib==3.5.3

• 使用conda环境的用户可执行：

conda install matplotlib=3.5.3

3. 运行环境限制排查 #

如果你在编辑器内嵌的预览窗口运行代码，部分环境会默认禁用原生交互功能：

• VSCode交互窗口、Jupyter系列环境：在代码开头添加魔法命令%matplotlib qt 或 %matplotlib tk，调用独立GUI窗口渲染
• PyCharm环境：进入设置→Python Scientific，取消勾选「Show plots in tool window」，使用独立窗口展示图表

4. 交互识别阈值调整 #

3.7以上版本的matplotlib默认点选识别阈值过小，容易出现hover/点击无响应的情况，可在创建散点图时显式指定容错像素值：

# 将原代码中picker=True修改为
ax.scatter(x,y,c=c, s=100, cmap=cmap, norm=norm, picker=5)

参数值为识别的像素范围，数值越大识别容错率越高。

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