桌面应用 / 系统课时

避免主线程执行耗时任务

避免主线程执行耗时任务

QML 界面出现点击无响应、动画停顿或窗口短暂“假死”时,常见原因不是渲染能力不足,而是 GUI 主线程正在执行文件读取、大量计算或同步等待。本节用工作对象加 QThread 的方式,把耗时计算移出主线程,并让结果通过信号安全返回界面。

学习目标

  • 识别会阻塞 QML GUI 线程的同步工作
  • 使用工作对象与 QThread 执行耗时任务
  • 用信号把结果送回主线程,并验证界面仍保持响应

为什么主线程会卡住

QML 的属性绑定、输入事件和大部分界面逻辑都依赖 GUI 线程及时处理事件。即使 Qt Quick 在部分平台使用独立渲染线程,GUI 线程长时间执行同步函数仍会让事件处理和界面状态更新停滞。

典型风险包括同步读取大文件、长循环计算、压缩解压、同步网络等待,以及从 QML 直接调用一个执行数百毫秒甚至数秒的 C++ 方法。把 QCoreApplication::processEvents() 塞进长任务并不是可靠修复;更稳妥的做法是让任务本身离开 GUI 线程。

GUI 主线程与工作线程的异步协作

Qt 的工作对象模式把一个 QObject 移入 QThread。跨线程信号可以排队到接收对象所属线程的事件循环中处理,因此 Worker 能在后台执行,而 AsyncService 留在主线程负责与 QML 交互。

实现一个异步计算服务

下面给出一个可运行的最小工程,示例以 Qt 6.5 及以上为基线。目录中包含 CMakeLists.txt、main.cpp、asyncservice.h、asyncservice.cpp 和 Main.qml。

asyncservice.h 定义工作对象和暴露给 QML 的服务。Worker 不设置父对象,才能移动到工作线程;服务本身仍由主线程创建。

cpp
#pragma once

#include <QObject>
#include <QString>
#include <QThread>

class Worker : public QObject
{
    Q_OBJECT
public slots:
    void calculate(int count);

signals:
    void done(const QString &result);
};

class AsyncService : public QObject
{
    Q_OBJECT
    Q_PROPERTY(bool busy READ busy NOTIFY busyChanged)

public:
    explicit AsyncService(QObject *parent = nullptr);
    ~AsyncService() override;

    bool busy() const { return m_busy; }
    Q_INVOKABLE void start(int count);

signals:
    void request(int count);
    void resultReady(const QString &result);
    void busyChanged();

private:
    QThread m_thread;
    Worker *m_worker = nullptr;
    bool m_busy = false;
};

asyncservice.cpp 只在 Worker 中执行循环。任务完成后,服务对象收到结果、恢复 busy 状态,再通知 QML。

cpp
#include "asyncservice.h"

void Worker::calculate(int count)
{
    quint64 sum = 0;
    for (int i = 0; i < count; ++i)
        sum += static_cast<quint64>(i);

    emit done(QString::number(sum));
}

AsyncService::AsyncService(QObject *parent)
    : QObject(parent),
      m_worker(new Worker)
{
    m_worker->moveToThread(&m_thread);

    connect(&m_thread, &QThread::finished,
            m_worker, &QObject::deleteLater);
    connect(this, &AsyncService::request,
            m_worker, &Worker::calculate);
    connect(m_worker, &Worker::done,
            this, [this](const QString &result) {
                m_busy = false;
                emit busyChanged();
                emit resultReady(result);
            });

    m_thread.start();
}

AsyncService::~AsyncService()
{
    m_thread.quit();
    m_thread.wait();
}

void AsyncService::start(int count)
{
    if (m_busy || count <= 0)
        return;

    m_busy = true;
    emit busyChanged();
    emit request(count);
}

main.cpp 把服务作为上下文属性交给 QML。服务的生命周期覆盖整个界面,因此退出时可以停止线程并等待其结束。

cpp
#include <QGuiApplication>
#include <QQmlApplicationEngine>
#include <QQmlContext>

#include "asyncservice.h"

int main(int argc, char *argv[])
{
    QGuiApplication app(argc, argv);

    AsyncService service;
    QQmlApplicationEngine engine;
    engine.rootContext()->setContextProperty("asyncService", &service);
    engine.loadFromModule("AsyncDemo", "Main");

    if (engine.rootObjects().isEmpty())
        return -1;

    return app.exec();
}

Main.qml 用持续旋转的小方块观察界面是否被阻塞。点击区域只负责发起请求,不执行长循环。

qml
import QtQuick

Window {
    width: 420
    height: 240
    visible: true
    title: "Async QML"

    property string resultText: "点击开始"

    Rectangle {
        id: spinner
        width: 36
        height: 36
        radius: 6
        anchors.horizontalCenter: parent.horizontalCenter
        y: 36

        RotationAnimator on rotation {
            from: 0
            to: 360
            duration: 900
            loops: Animation.Infinite
            running: true
        }
    }

    Text {
        anchors.centerIn: parent
        text: asyncService.busy ? "计算中…" : resultText
    }

    MouseArea {
        anchors.fill: parent
        onClicked: asyncService.start(80000000)
    }

    Connections {
        target: asyncService

        function onResultReady(result) {
            resultText = "结果:" + result
        }
    }
}

CMakeLists.txt 把 C++ 源文件和 QML 文件放进同一个应用目标。

cmake
cmake_minimum_required(VERSION 3.21)

project(AsyncQml LANGUAGES CXX)

set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED ON)

find_package(Qt6 6.5 REQUIRED COMPONENTS Quick)
qt_standard_project_setup(REQUIRES 6.5)

qt_add_executable(appAsyncQml
    main.cpp
    asyncservice.cpp
    asyncservice.h
)

qt_add_qml_module(appAsyncQml
    URI AsyncDemo
    QML_FILES
        Main.qml
)

target_link_libraries(appAsyncQml PRIVATE Qt6::Quick)

在已配置 Qt 6 的终端中构建:

bash
cmake -S . -B build
cmake --build build

预期输出

text
退出码为 0;构建目录中生成 appAsyncQml 可执行程序。具体构建进度文本和文件路径因平台与生成器不同而不同。

启动程序后点击窗口,旋转动画应继续运动,文本先显示“计算中…”,任务结束后显示 结果:3199999960000000。不同机器完成耗时不同,但计算期间窗口仍应能重绘和响应事件。

守住线程边界

后台线程适合纯计算、文件处理和能够安全在线程中使用的 I/O 对象,但不要在 Worker 中直接修改 QQuickItem、窗口或其他 GUI 对象。界面更新应通过信号回到主线程完成。

如果任务可能持续很久,还应增加取消机制和错误信号;如果同时存在大量短任务,则更适合评估线程池或 Qt Concurrent,而不是为每个任务创建独立线程。判断是否需要异步化的核心,是同步工作是否已经明显占用 GUI 线程并破坏交互连续性。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

避免主线程执行耗时任务

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通