QT中QThread线程实时更新textBrowser GUI的问题求助

核心问题分析 #

• Qt明确规定仅创建GUI控件的主线程可操作GUI，子线程直接调用ui->textBrowser->setText会触发线程上下文冲突，就是你遇到的parent's thread is ... current thread is ...报错。
• 你的线程类同时继承out（Widget）和QThread是错误设计：QThread是线程管理类，不应与Widget类混合继承；且新建t实例会生成一个独立的out控件，并非界面上正在显示的实例，自然看不到更新效果。
• 全局变量stop非线程安全，直接读写存在竞态风险。

正确实现方案 #

使用Qt信号槽机制实现跨线程通信：子线程在循环中发送携带文本的信号，主线程的Widget接收信号后安全更新textBrowser；同时用线程安全的方式控制线程启停。

修改后的完整代码 #

头文件（out.h）

#ifndef OUT_H
#define OUT_H

#include <QWidget>
#include <QThread>
#include <QAtomicBool>

namespace Ui {
class out;
}

// 工作线程类：负责循环生成/读取数据，发送文本信号
class Worker : public QObject
{
    Q_OBJECT
public:
    explicit Worker(QObject *parent = nullptr) : QObject(parent), m_running(false) {}

signals:
    void sendText(const QString &text); // 发送待显示文本的信号
    void workFinished(); // 线程结束通知信号

public slots:
    void startWork() {
        m_running = true;
        int i = 0;
        while (m_running.load()) {
            QString text = QString("hi %1").arg(i++);
            emit sendText(text);
            QThread::msleep(100); // 模拟UART读取延迟，避免循环占用过多CPU
        }
        emit workFinished();
    }

    void stopWork() {
        m_running = false;
    }

private:
    QAtomicBool m_running; // 线程安全的运行状态标记，替代全局stop变量
};

class out : public QWidget
{
    Q_OBJECT

public:
    explicit out(QWidget *parent = nullptr);
    ~out();

public slots:
    void updateTextBrowser(const QString &text); // 更新textBrowser的槽函数

private slots:
    void on_pushButton_clicked();

private:
    Ui::out *ui;
    Worker *m_worker;
    QThread *m_workerThread;
};

#endif // OUT_H

源文件（out.cpp）

#include "out.h"
#include "ui_out.h"

out::out(QWidget *parent) :
    QWidget(parent),
    ui(new Ui::out)
{
    ui->setupUi(this);
    ui->textBrowser->setText("lol");

    // 初始化工作线程与工作对象
    m_worker = new Worker();
    m_workerThread = new QThread();

    // 将工作对象移动到子线程
    m_worker->moveToThread(m_workerThread);

    // 连接信号槽，实现线程启停与跨线程通信
    connect(m_workerThread, &QThread::started, m_worker, &Worker::startWork);
    connect(m_worker, &Worker::sendText, this, &out::updateTextBrowser);
    connect(m_worker, &Worker::workFinished, m_workerThread, &QThread::quit);
    connect(m_workerThread, &QThread::finished, m_workerThread, &QThread::deleteLater);
    connect(m_workerThread, &QThread::finished, m_worker, &Worker::deleteLater);
}

out::~out()
{
    // 安全停止线程并清理资源
    if (m_workerThread->isRunning()) {
        m_worker->stopWork();
        m_workerThread->wait();
    }
    delete ui;
}

void out::updateTextBrowser(const QString &text)
{
    // 主线程中安全更新GUI，用append避免覆盖原有内容
    ui->textBrowser->append(text);
}

void out::on_pushButton_clicked()
{
    // 触发线程停止操作
    m_worker->stopWork();
}

// 外部启动线程的函数（需传入界面实例指针）
void mamad1(out *outInstance) {
    if (outInstance && !outInstance->m_workerThread->isRunning()) {
        outInstance->m_workerThread->start();
    }
}

关键说明 #

1. 线程安全控制：用QAtomicBool替代全局变量，保证多线程读写操作的原子性，避免竞态问题。
2. 跨线程通信：Worker的sendText信号与out的updateTextBrowser槽连接时，Qt自动使用队列连接模式，将信号事件放入主线程事件循环处理，确保GUI操作在主线程执行。
3. 规范线程设计：采用Worker + QThread的分离模式，工作对象继承QObject并通过moveToThread放入子线程，这是Qt官方推荐的线程使用方式。
4. 资源安全清理：线程结束时自动销毁Worker与QThread对象，析构函数中先停止线程再等待结束，避免内存泄漏与程序崩溃。

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