在PyQt界面集成matplotlib 3D图形遇ImportError问题求助

这个错误是因为你使用的matplotlib_backend_qtquick库未适配新版本的matplotlib。在较新的matplotlib版本中，MODIFIER_KEYS常量已经从matplotlib.backends.backend_qt5模块中移除，导致旧库的导入语句失效。

下面是几种可行的解决办法：

方法1：降级matplotlib到兼容版本 #

找到matplotlib_backend_qtquick支持的matplotlib版本（通常是3.6.x及更早版本），执行以下命令降级：

pip install matplotlib==3.6.3

这个版本经过测试可以和该库兼容，安装后重新运行代码即可。

方法2：手动修改matplotlib_backend_qtquick的源码 #

1. 找到报错的backend_qtquick.py文件，路径是你的虚拟环境下的venv/lib/python3.11/site-packages/matplotlib_backend_qtquick/backend_qtquick.py
2. 打开文件，找到第11行附近的导入语句：

   from matplotlib.backends.backend_qt5 import (
       MODIFIER_KEYS,
       # 其他导入项...
   )
   

3. 将MODIFIER_KEYS的导入路径修改为当前matplotlib中它所在的位置。在新版matplotlib中，它通常在matplotlib.backends.backend_qt5agg模块中，修改后示例：

   from matplotlib.backends.backend_qt5 import (
       # 保留其他原有的导入项
   )
   from matplotlib.backends.backend_qt5agg import MODIFIER_KEYS
   

4. 保存文件后重新运行代码。

方法3：换用官方兼容的嵌入方案（推荐） #

如果不想依赖第三方旧库，可以用PyQt官方的QWidget.createWindowContainer将matplotlib的画布嵌入QML，兼容性更好。示例代码如下：

main.py 代码 #

import os
import sys
from PyQt5 import QtQml, QtCore, QtWidgets
from PyQt5.QtCore import QUrl
from matplotlib.figure import Figure
from matplotlib.backends.backend_qt5agg import FigureCanvasQTAgg as FigureCanvas
from mpl_toolkits.mplot3d import Axes3D

class Mpl3DWidget(QtWidgets.QWidget):
    def __init__(self, parent=None):
        super().__init__(parent)
        self.figure = Figure()
        self.canvas = FigureCanvas(self.figure)
        layout = QtWidgets.QVBoxLayout(self)
        layout.addWidget(self.canvas)
        
        # 创建3D图形
        ax = self.figure.add_subplot(111, projection='3d')
        ax.plot3D([1,2,3], [4,5,6], [7,8,9], 'gray')
        self.canvas.draw()

os.environ['QT_QUICK_CONTROLS_STYLE'] = "Material"

# 注册QML可用的类型
QtQml.qmlRegisterType(Mpl3DWidget, "Backend", 1, 0, "Mpl3DWidget")

app = QtWidgets.QApplication(sys.argv)
engine = QtQml.QQmlApplicationEngine()
engine.load(QUrl.fromLocalFile('/home/vovi/PycharmProjects/pyqt5-qtquick2-example-master/pyqt5-qtquick2-example-master/pyqt5_qtquick2_example/qml/main.qml'))

if not engine.rootObjects():
    sys.exit(-1)

sys.exit(app.exec_())

QML中使用的示例（main.qml） #

import QtQuick 2.15
import QtQuick.Controls 2.15
import Backend 1.0

ApplicationWindow {
    visible: true
    width: 640
    height: 480
    title: qsTr("3D Plot in QML")

    WidgetContainer {
        anchors.fill: parent
        Mpl3DWidget {
            anchors.fill: parent
        }
    }
}

这个方案基于官方支持的Qt和matplotlib交互方式，不会因为版本更新出现兼容性问题。

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