如何用PySide6结合QML实现类似PyQt5+QtDesigner的多线程窗口应用

之前用PyQt5结合QtDesigner实现了带多线程的桌面应用，核心代码如下：

主窗口类 #

class MainUIClass(QtWidgets.QMainWindow, Ui_MainWindow):
    def __init__(self,parent=None):
        super().__init__()
        self.setupUi(self)

        # 创建线程
        self.thread_1 = QThread()
        # 创建工作对象
        self.worker_1 = Worker_1(self)
        # 将工作对象移到线程
        self.worker_1.moveToThread(self.thread_1)
        # 连接信号槽
        self.thread_1.started.connect(self.worker_1.run)
        # 启动线程
        self.thread_1.start(QThread.Priority.NormalPriority)

Worker类 #

class Worker_1(QObject):   
    def __init__(self,mainWin,parent = None):
        super(CoreWorker, self).__init__(parent)
        self.mainWin = mainWin
  
    def run(self):
        while True:
            pass
            # 执行任务

主函数 #

if __name__ == '__main__':
    app = QApplication(sys.argv)
    win = MainUIClass()
    win.show()
    sys.exit(app.exec_())

现在需要改用PySide6实现相同的多线程功能，但界面改用Qt Creator制作的QML文件，而非QtDesigner生成的Ui_MainWindow，该如何实现？

1. 准备QML界面文件 #

先在Qt Creator中创建QML界面（示例命名为main.qml），基础结构如下：

import QtQuick 2.15
import QtQuick.Window 2.15
import QtQuick.Controls 2.15

Window {
    width: 640
    height: 480
    visible: true
    title: qsTr("PySide6 QML多线程示例")

    // 用于显示线程状态的文本控件
    Text {
        id: statusText
        anchors.centerIn: parent
        text: qsTr("线程未启动")
    }
}

2. 实现Worker线程类 #

PySide6的线程逻辑和PyQt5基本一致，重点通过信号槽和QML交互（禁止直接在线程中操作QML对象，避免线程安全问题）：

from PySide6.QtCore import QObject, QThread, Signal

class Worker1(QObject):
    # 定义信号，用于向QML发送状态更新
    status_updated = Signal(str)

    def __init__(self, parent=None):
        super().__init__(parent)
        self._is_running = True

    def run(self):
        count = 0
        while self._is_running:
            # 模拟耗时任务
            count += 1
            self.status_updated.emit(f"线程运行中：{count}")
            QThread.msleep(1000)  # 休眠1秒

    def stop(self):
        # 终止循环，让线程可以正常退出
        self._is_running = False

3. 主程序整合QML与线程 #

主程序需要加载QML文件，创建线程与Worker实例，并完成信号槽的跨线程连接：

import sys
from PySide6.QtGui import QGuiApplication
from PySide6.QtQml import QQmlApplicationEngine
from PySide6.QtCore import QThread

class ThreadBridge(QObject):
    """用于管理线程生命周期的桥接类"""
    def __init__(self, worker, parent=None):
        super().__init__(parent)
        self.worker = worker
        self.thread = QThread()
        # 将Worker移到子线程
        self.worker.moveToThread(self.thread)
        # 线程启动时触发Worker的run方法
        self.thread.started.connect(self.worker.run)
        # 应用退出时清理线程资源
        app = QGuiApplication.instance()
        app.aboutToQuit.connect(self.worker.stop)
        app.aboutToQuit.connect(self.thread.quit)
        app.aboutToQuit.connect(self.thread.wait)

if __name__ == "__main__":
    app = QGuiApplication(sys.argv)
    engine = QQmlApplicationEngine()

    # 创建Worker和线程管理实例
    worker1 = Worker1()
    thread_bridge = ThreadBridge(worker1)

    # 将Worker对象暴露给QML，让QML可以接收其信号
    engine.rootContext().setContextProperty("worker1", worker1)

    # 加载QML文件
    engine.load("main.qml")

    if not engine.rootObjects():
        sys.exit(-1)

    # 启动线程
    thread_bridge.thread.start(QThread.Priority.NormalPriority)

    sys.exit(app.exec())

4. 调整QML接收线程信号 #

修改main.qml，让文本控件接收Worker发送的状态信号：

import QtQuick 2.15
import QtQuick.Window 2.15
import QtQuick.Controls 2.15

Window {
    width: 640
    height: 480
    visible: true
    title: qsTr("PySide6 QML多线程示例")

    Text {
        id: statusText
        anchors.centerIn: parent
        text: qsTr("线程未启动")

        // 连接Worker的信号，更新界面文本
        Connections {
            target: worker1
            function onStatus_updated(msg) {
                statusText.text = msg
            }
        }
    }
}

关键注意事项 #

• 线程安全：绝对不能在Worker线程中直接操作QML对象，必须通过信号槽传递数据，Qt会自动处理线程间的消息队列。
• 资源清理：应用退出时要先终止Worker的循环，再退出并等待线程结束，避免内存泄漏。
• 模块差异：PySide6加载QML用QQmlApplicationEngine，QML场景下推荐使用QGuiApplication作为应用类（兼容QApplication）。

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