如何在Qt Designer设计的GUI中显示Matplotlib对象并转换QGraphicsView为画布

我来帮你搞定这个问题！因为很多Qt Designer版本确实没有自带matplotlibwidget，所以我们可以自己动手，通过提升QGraphicsView为自定义类的方式，把Matplotlib画布嵌入进去，完全兼容你用Qt Designer做好的复杂GUI。

第一步：在Qt Designer里准备QGraphicsView控件 #

1. 打开你的GUI工程，拖一个QGraphicsView到界面上，给它起个好记的名字（比如mpl_view），方便后续在代码里调用。
2. 右键点击这个QGraphicsView，选择「提升为...」。
3. 在弹出的对话框里：
   • 「提升的类名称」填MplGraphicsView（这个名字要和我们后面Python里的类名完全一致）
   • 「头文件」填你的Python脚本文件名（比如如果代码写在main.py里，就填main；如果是单独的模块文件，比如mpl_widgets.py，就填mpl_widgets）
   • 点击「添加」，再点击「提升」。

这样，Qt Designer生成的UI文件就会把这个QGraphicsView识别为我们自定义的类了。

第二步：编写Python自定义类（集成Matplotlib画布） #

我们需要写一个继承自QGraphicsView的类，把Matplotlib的画布嵌入进去。核心思路是：创建Matplotlib的Figure和FigureCanvasQTAgg（Qt兼容的画布），把画布添加到QGraphicsScene里，再让QGraphicsView显示这个场景。

from PyQt5.QtWidgets import QGraphicsView, QGraphicsScene
from matplotlib.backends.backend_qt5agg import FigureCanvasQTAgg as FigureCanvas
from matplotlib.figure import Figure

class MplGraphicsView(QGraphicsView):
    def __init__(self, parent=None):
        super().__init__(parent)
        # 初始化Matplotlib的Figure对象（可以调整尺寸和DPI）
        self.figure = Figure(figsize=(5, 4), dpi=100)
        # 创建Qt兼容的画布
        self.canvas = FigureCanvas(self.figure)
        # 创建QGraphicsScene，把画布添加进去
        self.scene = QGraphicsScene(self)
        self.scene.addWidget(self.canvas)
        # 让QGraphicsView显示这个场景
        self.setScene(self.scene)
        # 添加一个子图，方便后续绘图
        self.ax = self.figure.add_subplot(111)
    
    def plot_data(self, x_data, y_data):
        # 清除之前的绘图（避免叠加）
        self.ax.clear()
        # 用Matplotlib绘图，这里可以换成你需要的任何图形（柱状图、散点图等）
        self.ax.plot(x_data, y_data, color='#2ecc71', linewidth=2, label='Sample Curve')
        # 设置图表样式
        self.ax.set_xlabel('X Value')
        self.ax.set_ylabel('Y Value')
        self.ax.set_title('Matplotlib in QGraphicsView')
        self.ax.legend()
        # 刷新画布，显示新图
        self.canvas.draw()

第三步：集成到你的GUI主程序里 #

假设你已经用Qt Designer做好了UI文件（比如叫main_window.ui），里面除了提升后的mpl_view，还有一个触发绘图的按钮plot_btn。下面是完整的主程序示例：

import sys
from PyQt5.QtWidgets import QApplication, QMainWindow
from PyQt5 import uic

# 上面的MplGraphicsView类要放在这里，或者导入进来

class MainWindow(QMainWindow):
    def __init__(self):
        super().__init__()
        # 加载Qt Designer生成的UI文件
        uic.loadUi('main_window.ui', self)
        # 绑定按钮点击事件，触发绘图
        self.plot_btn.clicked.connect(self.draw_graph)
    
    def draw_graph(self):
        # 测试数据，你可以换成自己的业务数据
        x = [1, 2, 3, 4, 5, 6]
        y = [2, 4, 7, 11, 16, 22]
        # 调用自定义视图的绘图方法
        self.mpl_view.plot_data(x, y)

if __name__ == '__main__':
    app = QApplication(sys.argv)
    window = MainWindow()
    window.show()
    sys.exit(app.exec_())

几个关键注意事项 #

• 如果你遇到界面卡死的情况，说明绘图操作太耗时，需要把绘图逻辑放到子线程里执行（避免阻塞UI线程）。
• 确保Matplotlib使用Qt5后端，可以在代码开头加上：import matplotlib; matplotlib.use('Qt5Agg')
• 如果你用pyuic5把UI文件转换成Python代码，要确保提升的类已经被正确导入（比如在转换后的代码里，会有from main import MplGraphicsView这样的导入语句，如果你的类在其他文件里，要修改这个导入路径）。

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