如何在PySide2应用中嵌入Matplotlib画布？关闭窗口崩溃问题求解

我之前踩过这个坑，关闭窗口时出现的Fatal Python error: deallocating None，本质是Matplotlib的Qt后端在PySide2环境下的资源释放顺序冲突导致的——默认情况下Matplotlib可能优先绑定PyQt5的资源管理逻辑，切换到PySide2后没有正确适配。下面是几个经过验证的解决方案：

1. 显式指定Matplotlib使用PySide2后端 #

在导入任何Matplotlib相关模块之前，强制设置后端为Qt5Agg并指定使用PySide2，这样能让Matplotlib一开始就适配PySide2的环境：

import matplotlib
# 先设置后端
matplotlib.use('Qt5Agg')
# 指定Qt5后端使用PySide2
matplotlib.rcParams['backend.qt5'] = 'PySide2'

# 之后再导入Matplotlib的其他模块和PySide2
from matplotlib.backends.backend_qt5agg import FigureCanvasQTAgg as FigureCanvas
from matplotlib.backends.backend_qt5agg import NavigationToolbar2QT as NavigationToolbar
from PySide2 import QtCore, QtWidgets

2. 重写窗口的closeEvent，手动清理Matplotlib资源 #

有时候即使指定了后端，资源释放顺序还是会出问题，这时候可以在主窗口类里重写closeEvent方法，先手动关闭Matplotlib的画布和工具栏，再让窗口正常关闭：

class MainWindow(QtWidgets.QMainWindow):
    def __init__(self, parent=None):
        super().__init__(parent)
        # 初始化你的UI和Matplotlib画布
        self.figure = matplotlib.figure.Figure()
        self.canvas = FigureCanvas(self.figure)
        self.toolbar = NavigationToolbar(self.canvas, self)
        # 布局设置...

    def closeEvent(self, event):
        # 先清理Matplotlib资源
        if hasattr(self, 'canvas'):
            self.canvas.close()
        if hasattr(self, 'toolbar'):
            self.toolbar.close()
        # 再执行父类的关闭逻辑
        super().closeEvent(event)

这样能确保Matplotlib的资源在窗口销毁前被正确释放，避免Python解释器在后续清理时遇到无效的None对象。

3. 避免混用PyQt5和PySide2的模块 #

确保你的代码里没有同时导入PyQt5和PySide2的模块——哪怕是间接导入也可能导致冲突。比如不要在同一个项目里既有from PyQt5 import ...又有from PySide2 import ...，保持环境的一致性。

通常把方法1和方法2结合起来用，就能彻底解决关闭窗口崩溃的问题了。

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