同学们好，我是码了只羊 —— 一个野生白羊座程序员，不混大厂，不写八股。专注用QT码点“小玩意儿”。

今天的主角是QThread —— 线程类。它可以让你在后台执行耗时任务，同时主界面保持流畅。这是 Qt 进阶的必经之路，也是面试常考题。别怕，跟着我走，保证你学会。

一、为什么需要多线程？

想象一下：你的软件只有一个“人”（主线程），它既要处理用户点击、刷新界面，又要做复杂的计算、读写文件。一旦计算耗时，它就没空理界面，于是界面就“卡死”了。多线程就是再雇几个“打工人”（子线程），把耗时任务交给他们，主线程只管界面和用户交互。这样，软件永远流畅。

二、QThread 的正确姿势（新手必看）

很多网上教程教你继承 QThread 重写 run()，但那其实是老式写法，容易出错。Qt 官方推荐的是 “Worker 对象 + moveToThread” 方式，安全、简洁。

步骤1：定义一个工作类（Worker）

// 工作类，继承 QObjectclass Worker : public QObject {    Q_OBJECTpublic:    explicit Worker(QObject *parent = nullptr) : QObject(parent) {}public slots:    void doWork() {        // 耗时任务，例如循环、文件IO、网络请求        for (int i = 0; i <= 100; ++i) {            QThread::msleep(50);  // 模拟耗时            emit progressChanged(i);  // 发送进度信号        }        emit finished();    }signals:    void progressChanged(int value);    void finished();};

步骤2：在主线程中创建 QThread 和 Worker

// 创建线程对象QThread *thread = new QThread(this);// 创建工作对象（注意：不能指定父对象为 this）Worker *worker = new Worker;  // 无父对象// 将 worker 移动到线程中worker->moveToThread(thread);// 连接信号和槽connect(thread, &QThread::started, worker, &Worker::doWork);connect(worker, &Worker::progressChanged, this, &MainWindow::updateProgress);connect(worker, &Worker::finished, thread, &QThread::quit);connect(worker, &Worker::finished, worker, &QObject::deleteLater);connect(thread, &QThread::finished, thread, &QObject::deleteLater);// 启动线程thread->start();

这样，当线程启动时，会自动调用 worker 的 doWork() 函数，且运行在子线程中。进度通过信号传给主线程更新 UI，完美。

三、跨线程通信：信号槽是王道

Qt 的信号槽是线程安全的，当你跨线程连接时，Qt 会自动选择合适的队列方式传递消息。因此，你可以在子线程中发射信号，主线程中的槽函数会安全地执行。

// 主线程中接收信号connect(worker, &Worker::progressChanged, this, [this](int value){    ui->progressBar->setValue(value);   // 安全更新 UI});

注意：绝对不要在子线程中直接操作 UI 控件（比如 setText()），那会导致程序崩溃。所有 UI 操作必须放到主线程。而信号槽正是从子线程安全回到主线程的最佳途径。

四、实战：文件搜索不卡界面

我们来实现小张的需求：在指定目录搜索包含关键词的文件，实时显示结果，且界面不卡。

// Worker 类class FileSearchWorker : public QObject {    Q_OBJECTpublic:    void setPath(const QString &path) { m_path = path; }    void setKeyword(const QString &kw) { m_keyword = kw; }public slots:    void doSearch() {        QDirIterator it(m_path, QDir::Files, QDirIterator::Subdirectories);        while (it.hasNext()) {            if (m_cancel) break;            QString filePath = it.next();            if (filePath.contains(m_keyword)) {                emit resultFound(filePath);            }            QThread::msleep(10); // 模拟耗时，实际可以不加        }        emit finished();    }    void cancel() { m_cancel = true; }signals:    void resultFound(const QString &filePath);    void finished();private:    QString m_path;    QString m_keyword;    bool m_cancel = false;};// 主窗口中使用void MainWindow::onSearchClicked() {    QString path = ui->pathEdit->text();    QString keyword = ui->keywordEdit->text();    if (path.isEmpty() || keyword.isEmpty()) return;    // 创建线程和 worker    QThread *thread = new QThread(this);    FileSearchWorker *worker = new FileSearchWorker;    worker->setPath(path);    worker->setKeyword(keyword);    worker->moveToThread(thread);    connect(thread, &QThread::started, worker, &FileSearchWorker::doSearch);    connect(worker, &FileSearchWorker::resultFound, this, &MainWindow::addResult);    connect(worker, &FileSearchWorker::finished, thread, &QThread::quit);    connect(worker, &FileSearchWorker::finished, worker, &QObject::deleteLater);    connect(thread, &QThread::finished, thread, &QObject::deleteLater);    // 取消按钮    connect(ui->cancelButton, &QPushButton::clicked, worker, &FileSearchWorker::cancel);    thread->start();}

这样，搜索在后台进行，主界面可以随时点击取消，搜索结果实时显示，用户再也不会骂你的软件是PPT了。

总结（记住这几句，明天就能用）

今天的课就到这里。如果你曾经因为界面卡顿被用户吐槽，请在评论区分享你的故事（让我开心一下）。下一期我们讲 QDateTimeEdit 和 QSpinBox，让用户轻松选择数字和日期～         评论区见，码了只羊在线陪聊。