Matplotlib嵌入PyQt5后自定义画布无法显示内容的技术咨询

嘿，我看到你在PyQt5项目里集成Matplotlib时遇到了画布显示的问题，核心原因是你误用了Matplotlib的pyplot全局绘图接口，而没有使用自定义FigureCanvas自带的绘图对象。咱们来一步步修复：

问题根源 #

你在MyStaticMplCanvas的compute_initial_figure方法里调用了plt.imshow、plt.plot和plt.show——这些都是pyplot模块的全局函数，会创建独立的绘图上下文，和你继承的FigureCanvas里的fig、axes完全无关。这就导致图形会弹出单独的Matplotlib窗口，而不是渲染到你的Qt控件里。

修改后的代码实现 #

1. 修复MyStaticMplCanvas的绘图逻辑

把所有plt.xxx的调用替换成self.axes.xxx，并且删掉plt.show()：

class MyStaticMplCanvas(MyMplCanvas):
    """Simple canvas with custom plot."""
    def compute_initial_figure(self, img):
        pattern, code, label = self.freeman(img)  # 从外部函数获取数据
        # 使用画布自带的axes对象绘图
        self.axes.imshow(label, cmap='Greys')
        # 提取坐标并绘制路径
        x_coords = [i[1] for i in pattern]
        y_coords = [i[0] for i in pattern]
        self.axes.plot(x_coords, y_coords, color='red')  # 可以指定颜色让路径更明显
        # 绝对不要调用plt.show()！这会弹出独立窗口

2. 主窗口中正确初始化并触发绘图

在实例化画布后，记得传入你的img数据并调用绘图方法，必要时刷新画布：

# 实例化自定义画布
self.sc = MyStaticMplCanvas(self.tab_2, width=2, height=2, dpi=100)
self.sc.setGeometry(QtCore.QRect(70, 320, 300, 300))
# 传入你的img数据并执行绘图
self.sc.compute_initial_figure(your_img_data)
# 刷新画布确保图形显示
self.sc.draw()

3. 可选：优化MyMplCanvas的初始化（更规范）

用super()替代直接调用父类构造函数，符合Python继承的最佳实践：

class MyMplCanvas(FigureCanvas):
    """Ultimately, this is a QWidget (as well as a FigureCanvasAgg, etc.)."""
    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)  # 替代原来的FigureCanvas.__init__(self, fig)
        self.setParent(parent)
        self.setSizePolicy(QtWidgets.QSizePolicy.Expanding, QtWidgets.QSizePolicy.Expanding)
        self.updateGeometry()
    
    def compute_initial_figure(self, img):
        pass

关键注意事项 #

• 永远使用自定义画布的self.axes（或self.figure）进行绘图操作，完全避免使用plt的全局函数，否则会脱离Qt的绘图上下文。
• 禁止调用plt.show()，这会启动Matplotlib独立的GUI事件循环，和Qt的事件循环冲突，同时弹出不必要的窗口。
• 当绘图内容更新后，必须调用self.draw()来刷新画布，让新图形显示出来。

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