📚 课程目录第2章 QT多线程基础

第二章 QT多线程基础：QThread类的核心概念、线程生命周期、启动与停止线程、线程优先级设置

多线程编程是构建高性能、响应迅速应用程序的关键技术。在QT框架中，QThread类是所有多线程应用的核心基石。本章将深入剖析QThread的核心概念、线程的完整生命周期、启动与停止的规范操作，以及线程优先级的精细控制。理解这些基础原理，是后续掌握线程同步、通信与高级并发模式的前提。我们将从理论模型出发，结合实战代码与常见误区，帮助你建立扎实的QT多线程知识框架。

在QT的并发框架中，QThread对象本身并不等同于操作系统线程。更准确地说，QThread是管理一个操作系统线程的“控制手柄”或“门面”。它提供了跨平台的线程管理接口，封装了底层平台（如Windows的CreateThread或Linux的pthread_create）的差异。理解这一本质区别，是避免后续诸多使用陷阱的第一步。

2.1 QThread核心概念：控制器与执行体的分离

许多初学者误以为继承QThread并重写run()函数就是多线程的全部。实际上，QT官方推荐的做法是“工作对象（Worker Object） + 线程对象（Thread Object）”的分离模式。在这种模式下，QThread只负责管理线程的生命周期和事件循环，而具体的业务逻辑被封装在一个继承自QObject的工作类中，通过moveToThread()方法将该工作对象移入子线程。

核心原理拆解：

线程入口点：默认的run()实现会调用exec()，开启一个事件循环（QEventLoop）。这意味着该线程可以接收并处理信号、槽和定时器事件。
亲和性（Affinity）：每个QObject实例都有“线程亲和性”，即它属于哪个线程。默认情况下，对象创建于主线程，其亲和性就是主线程。通过moveToThread()可以改变亲和性，使得该对象的槽函数在目标线程中执行。
信号槽连接方式：当信号与槽跨越线程边界时，QT会自动使用Qt::QueuedConnection（队列连接），将槽函数的调用事件投递到接收者所在线程的事件循环中，从而保证线程安全。

这种设计的优势在于：工作对象可以充分利用信号槽机制与主线程通信，而无需手动管理锁和共享内存。同时，由于run()默认开启了事件循环，我们可以通过向线程投递事件或调用槽函数来优雅地控制线程的暂停与恢复。

2.2 线程生命周期：从创建到销毁的完整旅程

一个QThread对象从创建到销毁，会经历一系列明确的状态变化。理解这些状态及其转换条件，是编写健壮多线程代码的基础。下表总结了线程的主要生命周期阶段：

阶段	状态描述	触发条件	关键信号/方法
创建	对象已实例化，但底层线程尚未启动。	`new QThread()` 或栈上创建	`isRunning()` 返回 `false`
启动	操作系统线程已创建，`run()` 开始执行。	调用 `start()` 方法	信号 `started()` 发出
运行	事件循环正在运行，或 `run()` 正在执行耗时任务。	`exec()` 被调用（默认）	`isRunning()` 返回 `true`
停止请求	请求线程退出事件循环，但尚未完全终止。	调用 `quit()` 或 `exit(0)`	事件循环返回
结束	`run()` 函数返回，底层线程终止。	`run()` 执行完毕	信号 `finished()` 发出
销毁	释放 `QThread` 对象占用的资源。	调用 `deleteLater()` 或 `delete`	对象内存被回收

一个常见的生命周期管理误区是：在run()函数返回后，立即delete线程对象。这会导致程序崩溃，因为finished()信号可能尚未处理完毕。正确的做法是连接finished()信号到deleteLater()槽，确保线程完全结束后再销毁对象。

2.3 启动与停止线程：规范操作与危险禁区

启动线程相对简单，只需调用start()方法。但停止线程却充满了陷阱。QT提供了两种停止线程的方式：优雅停止与强制终止。

2.3.1 优雅停止：协作式退出

优雅停止依赖于线程内部的协作。通常做法是：

在工作对象中设置一个volatile bool m_stop标志位（或使用std::atomic<bool>）。
在耗时循环中检查该标志位，一旦为true，则跳出循环并返回。
主线程调用quit()（如果线程有事件循环）或通过信号槽请求工作对象停止。
最后调用wait()方法阻塞等待，直到run()函数返回。

// 工作对象
class Worker : public QObject {
    Q_OBJECT
public:
    Worker() : m_stop(false) {}
public slots:
    void doWork() {
        while (!m_stop) {
            // 执行耗时任务...
            QThread::msleep(10);
        }
        emit workFinished();
    }
    void stop() { m_stop = true; }
signals:
    void workFinished();
private:
    std::atomic<bool> m_stop;
};

// 主线程中
QThread* thread = new QThread;
Worker* worker = new Worker;
worker->moveToThread(thread);
connect(thread, &QThread::started, worker, &Worker::doWork);
connect(worker, &Worker::workFinished, thread, &QThread::quit);
connect(worker, &Worker::workFinished, worker, &Worker::deleteLater);
connect(thread, &QThread::finished, thread, &QThread::deleteLater);
thread->start();

// 请求停止
worker->stop(); // 直接调用槽，由于线程亲和性，实际在子线程中执行
thread->wait(); // 等待线程完全结束

2.3.2 强制终止：万不得已的禁区

terminate()方法会立即终止底层线程，不执行任何清理代码，不发出finished()信号。这可能导致死锁（如果线程持有锁）、资源泄漏或内存损坏。在绝大多数情况下，应避免使用terminate()。如果确实需要强制终止（例如程序退出时），请务必在调用terminate()后立即调用wait()，并做好资源清理的补救措施。

风险警告： 在QT文档中明确说明，terminate()是危险函数。它不会运行栈上的析构函数，也不会释放任何RAII资源。如果线程正在操作共享数据，强制终止将导致数据不一致。请始终优先设计可协作停止的线程逻辑。

2.4 线程优先级设置：权衡与策略

线程优先级决定了操作系统调度器如何分配CPU时间片。QT通过QThread::Priority枚举提供优先级设置，但需要注意：优先级设置是“建议性”的，具体行为取决于操作系统。例如，Linux下可能需要特殊权限才能设置高优先级。

设置优先级应在调用start()之前进行，或者在线程启动后通过setPriority()动态调整。常见的优先级策略包括：

实时性任务：使用TimeCriticalPriority，但需谨慎，可能阻塞其他重要系统任务。
交互式任务：使用HighPriority，确保UI响应流畅。
后台计算任务：使用LowPriority或IdlePriority，避免影响前台性能。

QThread* thread = new QThread;
thread->setPriority(QThread::HighPriority); // 在启动前设置
thread->start();

// 动态调整
if (thread->isRunning()) {
    thread->setPriority(QThread::LowPriority);
}

经验提示： 不要过度依赖优先级来解决性能问题。频繁的优先级切换会增加系统调度开销。更好的做法是合理设计任务队列和线程池，让操作系统在默认优先级下高效工作。优先级设置应作为“最后手段”用于特定场景。

2.5 实战案例：构建一个可取消的图像处理线程

让我们通过一个完整的案例来巩固本章知识。假设我们需要开发一个图像处理应用，用户点击“开始处理”后，程序在后台线程中执行高斯模糊，同时显示进度条。用户点击“取消”时，线程应尽快停止。

案例背景与约束：

图像尺寸为 4000x3000 像素，处理耗时约 5 秒。
UI 必须保持流畅，不能阻塞主线程。
取消操作必须在 1 秒内响应。

实现步骤：

创建ImageProcessor工作类，包含processImage()和cancel()槽函数。
在processImage()中，循环处理每一行像素，并检查m_cancel标志。
每处理完一行，发出progressUpdated(int)信号。
主线程连接progressUpdated信号更新进度条。
点击取消按钮，调用processor->cancel()，并设置标志位。
线程检测到标志位后，退出循环，发出finished()信号。

关键代码片段：

class ImageProcessor : public QObject {
    Q_OBJECT
public:
    ImageProcessor() : m_cancel(false) {}
public slots:
    void processImage() {
        for (int y = 0; y < 3000; ++y) {
            if (m_cancel) break;
            // 模拟像素处理
            QThread::msleep(1);
            emit progressUpdated((y + 1) * 100 / 3000);
        }
        emit processingFinished();
    }
    void cancel() { m_cancel = true; }
signals:
    void progressUpdated(int percent);
    void processingFinished();
private:
    std::atomic<bool> m_cancel;
};

结果对比与复盘：

通过协作式取消，我们在 1 秒内成功停止了线程，且没有出现内存泄漏或崩溃。如果使用terminate()，虽然响应更快，但可能导致图像数据损坏。复盘经验：线程停止的关键在于“协作”而非“强制”。设计时，应始终为耗时循环提供检查点，并确保资源在退出路径上被正确释放。

2.6 常见误区与总结复盘

在本章的学习中，有几个高频误区需要特别留意：

误区一：在QThread对象上直接调用其槽函数。 如果QThread对象本身在主线程中创建，那么直接调用它的槽（如start()）会在主线程执行，而不是子线程。正确的做法是，将工作对象moveToThread()，然后通过信号触发其槽。

误区二：忘记调用wait()就销毁线程对象。 这会导致“QThread: Destroyed while thread is still running”错误。务必在销毁前确保线程已结束。

误区三：在子线程中直接操作GUI组件。 所有GUI操作必须在主线程进行。子线程只能通过信号通知主线程更新界面。

总结复盘： 本章我们掌握了QThread作为线程控制器的本质，理解了线程从创建到销毁的完整生命周期，学会了通过协作标志位优雅地停止线程，并了解了优先级设置的原则。这些基础知识将为你后续学习线程同步（QMutex、QSemaphore）和高级并发框架（QtConcurrent）打下坚实基础。记住，多线程编程的核心不是“同时执行”，而是“安全地协调执行”。