macOS Ventura下PySide6集成Matplotlib运行失败求助

问题原因 #

报错信息里的ControzlModifier是拼写错误（正确应为ControlModifier），本质是你使用了适配Qt5的Qt5Agg后端，但实际安装的是PySide6（对应Qt6），版本不匹配导致Matplotlib调用了不存在的属性；此外旧版本Matplotlib对PySide6的支持存在兼容性缺陷。

解决方案 #

1. 切换到Qt6专属后端
   将matplotlib.use('Qt5Agg')改为matplotlib.use('Qt6Agg')，同时把导入的后端模块从backend_qt5agg替换为backend_qt6agg，确保后端与Qt版本匹配。

2. 升级Matplotlib到兼容版本
   确保Matplotlib版本在3.5.0及以上，该版本开始完善对PySide6的支持，执行以下命令升级：

   pip install --upgrade matplotlib
   

3. 修正后的完整代码

   import sys
   import matplotlib
   
   # 使用适配PySide6的Qt6后端
   matplotlib.use('Qt6Agg')
   
   from PySide6.QtWidgets import QMainWindow, QApplication
   # 导入Qt6对应的Matplotlib画布类
   from matplotlib.backends.backend_qt6agg import FigureCanvasQTAgg
   from matplotlib.figure import Figure
   
   
   class MplCanvas(FigureCanvasQTAgg):
       def __init__(self, parent=None, width=5, height=4, dpi=100):
           fig = Figure(figsize=(width, height), dpi=dpi)
           self.axes = fig.add_subplot(111)
           super().__init__(fig)
   
   
   class MainWindow(QMainWindow):
       def __init__(self, *args, **kwargs):
           super().__init__(*args, **kwargs)
   
           sc = MplCanvas(self, width=5, height=4, dpi=100)
           sc.axes.plot([0,1,2,3,4], [10,1,20,3,40])
           self.setCentralWidget(sc)
   
           self.show()
   
   
   app = QApplication(sys.argv)
   w = MainWindow()
   app.exec()
   

额外注意事项 #

• 禁止混用Qt5/Qt6后端与对应版本的PyQt/PySide库：PyQt5/PySide5对应Qt5Agg，PyQt6/PySide6对应Qt6Agg。
• 检查虚拟环境是否同时安装了PyQt5和PySide6，若有则卸载不需要的绑定库，避免环境冲突。

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