Matplotlib3+PyQt5多线程应用自定义后端移植问题求助

核心思路 #

解决非主线程创建Matplotlib图形的核心是将所有Qt GUI相关的Matplotlib操作，通过信号槽机制转发到Qt主线程执行，同时规避new_figure_manager的无限递归问题——递归根源是自定义后端调用pyplot.new_figure_manager时，会触发后端自身的new_figure_manager回调，形成循环。

最小化后端实现代码 #

import matplotlib
matplotlib.use('module://my_backend')  # 先指定自定义后端

import matplotlib.pyplot as plt
from matplotlib.backends.backend_qt5agg import FigureManagerQT, FigureCanvasQTAgg
from matplotlib.backend_bases import _Backend
from PyQt5.QtCore import QObject, pyqtSignal, QCoreApplication
import functools

# 主线程任务调度器
class ConnectedQApp(QObject):
    submit_task = pyqtSignal(object)

    def __init__(self):
        super().__init__()
        self.submit_task.connect(self._run_in_gui)
        # 确保调度器对象驻留主线程
        self.moveToThread(QCoreApplication.instance().thread())

    def _run_in_gui(self, func):
        func()

    def execInGui(self, func, *args, **kwargs):
        # 若当前已是主线程，直接执行；否则通过信号转发
        if QCoreApplication.instance().thread() == self.thread():
            func(*args, **kwargs)
        else:
            bound_func = functools.partial(func, *args, **kwargs)
            self.submit_task.emit(bound_func)

# 全局调度实例
qapp_scheduler = ConnectedQApp()

# 自定义后端
class _BackendMyQtAgg(_Backend):
    # 复用Matplotlib原生Qt5组件
    FigureCanvas = FigureCanvasQTAgg
    FigureManager = FigureManagerQT

    @classmethod
    def new_figure_manager(cls, num, *args, **kwargs):
        # 关键：跳过pyplot的递归调用，直接调用父类方法并转发到主线程
        manager = None
        def create_manager():
            nonlocal manager
            manager = super().new_figure_manager(num, *args, **kwargs)
        qapp_scheduler.execInGui(create_manager)
        return manager

    @classmethod
    def show(cls, figure):
        # 将图形显示操作转发到主线程
        qapp_scheduler.execInGui(super().show, figure)

# 注册自定义后端
matplotlib.backends.register_backend('my_backend', _BackendMyQtAgg)

关键细节说明 #

• 规避递归：在new_figure_manager中直接调用父类_Backend的方法，而非pyplot.new_figure_manager，避免触发后端回调循环。
• 线程安全：所有GUI操作（创建图形管理器、显示图形）都通过ConnectedQApp的信号槽转发到主线程，符合Qt的GUI线程安全规则。
• 最小化定制：复用Matplotlib原生的FigureCanvasQTAgg和FigureManagerQT，仅重写必要的方法，减少自定义代码维护成本。

非主线程脚本使用示例 #

import threading
import time

def script_thread():
    time.sleep(1)  # 模拟脚本业务逻辑执行
    # 在非主线程直接调用pyplot API
    plt.figure()
    plt.plot([1,3,2], [5,1,4])
    plt.title("Non-main Thread Plot")
    plt.show()

# 启动脚本线程
threading.Thread(target=script_thread).start()

# 你的Qt应用主线程运行代码（已有代码无需修改）
app = QCoreApplication.instance()
if app is None:
    from PyQt5.QtWidgets import QApplication
    app = QApplication([])
app.exec_()

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