PyQt窗口内嵌Matplotlib图形缩放与边框适配问题求解

两个核心问题的根源：

1. PyQt的QMainWindow不支持直接设置布局，必须依托中心控件（central widget）承载布局，否则画布无法接收到窗口尺寸变化的信号，自然不会同步缩放。
2. 硬编码Figure固定宽高、未关闭坐标轴默认等比例约束，会导致窗口宽高比和预设Figure比例不一致时出现留白。
3. 嵌入Qt场景时使用plt的全局状态接口容易引发布局冲突，建议直接操作Figure实例。

具体修改点 #

• 给QMainWindow设置中心控件，将布局挂载到中心控件上
• 移除Figure固定宽高的硬编码，给画布设置Expanding尺寸策略，让它自动跟随布局填充可用空间
• 创建占满Figure的坐标轴后，显式设置ax.set_aspect('auto')，取消默认的等比例约束，适配任意窗口宽高比
• 替换所有plt全局调用为Figure/Axes实例的方法，避免全局状态干扰
• 窗口尺寸变化触发画布重绘时，自动调整布局保证边距为0
• 将布局的内容边距设为0，消除窗口边缘的默认空隙

修改后可直接运行的代码 #

import sys
import matplotlib
matplotlib.use("Qt5Agg")

from PyQt5 import QtWidgets
from matplotlib.backends.backend_qt5agg import FigureCanvasQTAgg
from matplotlib.figure import Figure
from netgraph import EditableGraph


class MplCanvas(FigureCanvasQTAgg):
    def __init__(self, parent=None):
        # 直接实例化Figure，不使用plt全局接口，不预设固定宽高
        figure = Figure(frameon=False)
        super().__init__(figure)
        self.setParent(parent)
        # 设置尺寸策略为可扩展，占满所有可用布局空间
        self.setSizePolicy(QtWidgets.QSizePolicy.Expanding, QtWidgets.QSizePolicy.Expanding)
        self.updateGeometry()

        # 创建占满整个Figure的坐标轴，关闭边框和刻度显示
        self.ax = figure.add_axes([0, 0, 1, 1], frameon=False)
        self.ax.axis('off')
        # 关键：设置坐标轴比例为自动，适配任意窗口宽高比，避免非正方形窗口留白
        self.ax.set_aspect('auto')

        # 初始化可编辑图
        self.graph = EditableGraph([(0, 1)], ax=self.ax)
        self.ax.autoscale(axis='both', tight=True)

    def resizeEvent(self, event):
        # 窗口尺寸变化时，同步更新Figure尺寸并重绘
        super().resizeEvent(event)
        self.figure.tight_layout(pad=0)
        self.draw()


class MainWindow(QtWidgets.QMainWindow):
    def __init__(self, *args, **kwargs):
        super().__init__(*args, **kwargs)
        # QMainWindow必须设置中心控件，不能直接挂布局
        central_widget = QtWidgets.QWidget()
        self.setCentralWidget(central_widget)

        self.canvas = MplCanvas(self)
        vbl = QtWidgets.QVBoxLayout(central_widget)
        # 布局边距设为0，避免窗口边缘留白
        vbl.setContentsMargins(0, 0, 0, 0)
        vbl.addWidget(self.canvas)


def main():
    app = QtWidgets.QApplication(sys.argv)
    w = MainWindow()
    w.show()
    app.exec_()


if __name__ == "__main__":
    main()

效果说明 #

• 窗口任意缩放时，画布会自动跟随填充整个客户区，不会出现固定尺寸的留白
• 无论窗口是正方形还是任意比例的矩形，绘图区域都会完全贴合窗口边缘，不会出现比例不匹配导致的边框空隙
• 移除了冗余的plt全局调用，在Qt嵌入场景下运行更稳定，不会出现多窗口冲突问题

内容的提问来源于stack exchange，提问作者Lavínia Beghini