Qt GUI中Matplotlib组件多轴初始显示错位问题求助

我之前也碰到过一模一样的情况——在PyQt里嵌入Matplotlib多子图时，启动界面轴总是错位，但只要微调一下窗口像素就恢复正常。这其实是Matplotlib在Qt容器尺寸还没完全确定时就提前计算了布局导致的，原生Matplotlib没这个问题是因为它自身的窗口会先完成布局渲染，而PyQt的布局系统需要一点时间来计算控件的最终尺寸。

下面给你几个可行的解决方法，结合你的代码调整出了可用版本：

方法1：在窗口完全显示后再处理绘图和布局 #

重写窗口的showEvent方法，确保在窗口加载完成、容器尺寸确定后，再执行Matplotlib的绘图和布局调整：

from PyQt5.Qt import *
from matplotlib.backends.backend_qt5agg import FigureCanvasQTAgg as FigureCanvas
from matplotlib.figure import Figure
import numpy as np

class WidgetPlot(QWidget):
    def __init__(self, parent=None):
        QWidget.__init__(self, parent)
        self.setLayout(QVBoxLayout())
        self.canvas = PlotCanvas(self)
        self.layout().addWidget(self.canvas)

class PlotCanvas(FigureCanvas):
    def __init__(self, parent = None, width = 1, height = 1, dpi = 100):
        self.fig = Figure(figsize = (width, height), dpi = dpi)
        self.ax1 = self.fig.add_subplot(131)
        self.ax2 = self.fig.add_subplot(132)
        self.ax3 = self.fig.add_subplot(133)
        self.axes = self.ax1, self.ax2, self.ax3
        FigureCanvas.__init__(self, self.fig)
        self.setParent(parent)

class TraceWindow(QMainWindow):
    def __init__(self, parent=None):
        super().__init__(parent)
        self.setupUi()
        
    def setupUi(self):
        self.setObjectName("TraceWindow")
        self.resize(1000, 500)
        self.centralWidget = QWidget(self)
        self.centralWidget.setObjectName("centralWidget")
        self.gridLayout_2 = QGridLayout(self.centralWidget)
        self.gridLayout = QGridLayout()
        self.mpl_LayoutBox = QVBoxLayout()
        self.gridLayout.addLayout(self.mpl_LayoutBox, 3, 1, 1, 1)
        self.gridLayout_2.addLayout(self.gridLayout, 1, 0, 1, 1)
        self.setCentralWidget(self.centralWidget)
        
        # 实例化绘图控件
        self.m = WidgetPlot()
        self.canvas = self.m.canvas
        self.mpl_LayoutBox.addWidget(self.m)
        
    def showEvent(self, event):
        super().showEvent(event)
        # 窗口显示完成后再执行绘图和布局
        self.drawStuff()
        
    def drawStuff(self):
        # 用随机数组替代空数组，方便测试时看到图像效果
        a = np.random.rand(500, 500)
        for ax in self.canvas.axes:
            ax.clear()
            ax.imshow(a)
        
        # 先让Matplotlib更新轴的尺寸信息
        self.canvas.draw_idle()
        # 调用tight_layout调整布局
        self.canvas.fig.tight_layout()
        # 最终绘制画布
        self.canvas.draw()

if __name__ == "__main__":
    import sys
    app = QApplication(sys.argv)
    window = TraceWindow()
    window.show()
    sys.exit(app.exec_())

方法2：用QTimer延迟执行绘图 #

如果你不想修改窗口类结构，也可以在setupUi中用QTimer.singleShot延迟100ms左右执行绘图，给Qt足够时间完成布局计算：

把你原代码中的self.drawStuff()替换成：

QTimer.singleShot(100, self.drawStuff)

关键调整点说明 #

1. 移除了Figure初始化时的tight_layout=True，改为在绘制完轴内容后手动调用——这样能确保Matplotlib基于实际的轴尺寸计算布局。
2. 添加draw_idle()先让Matplotlib完成轴的尺寸更新，再执行tight_layout，避免布局计算基于临时尺寸。
3. 把绘图逻辑放到窗口显示之后，确保PyQt的布局系统已经确定了容器的最终大小。

这样修改后，启动GUI时Matplotlib的多轴就能正常对齐，不需要手动调整窗口了。

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