QT5中setOverrideCursor阻塞前置操作，状态栏消息延迟显示问题

原因 #

Qt的UI更新逻辑依赖事件循环：调用statusBar()->showMessage()只是将状态栏更新的事件加入到事件队列中，并不会立即触发界面绘制。而你后续的等待光标设置、数据库加载、GUI初始化都是CPU密集型操作，这些代码会在主线程中连续执行，直接阻塞了事件循环。直到restoreOverrideCursor()执行完毕，主线程才会有空处理之前积压的状态栏更新事件，导致消息延迟显示。

解决方案 #

方法1：手动触发事件处理（快速修复） #

在调用setOverrideCursor()之前，强制Qt处理当前pending的UI事件，让状态栏消息先绘制出来：

void loadDatabase(const QString &name) {
    // 设置状态栏消息
    statusBar()->showMessage("loading coverage database...");
    
    // 强制处理pending的UI事件，确保消息立即显示
    QApplication::processEvents(QEventLoop::AllEvents, 100);

    QApplication::setOverrideCursor(Qt::WaitCursor);
    // 后续CPU密集操作
    m_logger_widget->clear();
    m_logger_widget->info("opening database %s", name.toStdString().data());
    auto coverage_database = new CoverageDatabase(name, m_logger_widget);
    m_instance_view->setModel(coverage_database->getInstanceModel());
    QApplication::restoreOverrideCursor();
}

processEvents()的第二个参数是超时时间（毫秒），确保不会在这里无限等待，避免意外情况。

方法2：将密集操作移至子线程（最佳实践） #

主线程长期被阻塞会导致整个界面卡顿，符合Qt最佳实践的做法是把数据库加载这类耗时操作放到子线程中执行：

1. 先定义一个负责加载数据库的工作类：

class DatabaseLoader : public QObject
{
    Q_OBJECT
public slots:
    void load(const QString &name, LoggerWidget *logger) {
        // 子线程中执行耗时操作
        auto coverage_database = new CoverageDatabase(name, logger);
        emit loadFinished(coverage_database);
    }
signals:
    void loadFinished(CoverageDatabase *db);
};

2. 改造loadDatabase函数，让主线程只处理UI更新：

void loadDatabase(const QString &name) {
    // 立即更新状态栏
    statusBar()->showMessage("loading coverage database...");
    QApplication::setOverrideCursor(Qt::WaitCursor);

    // 启动子线程执行加载
    DatabaseLoader *loader = new DatabaseLoader();
    QThread *thread = new QThread();
    loader->moveToThread(thread);

    connect(thread, &QThread::started, [=]() {
        loader->load(name, m_logger_widget);
    });
    connect(loader, &DatabaseLoader::loadFinished, this, [=](CoverageDatabase *db) {
        // 加载完成后更新GUI
        m_instance_view->setModel(db->getInstanceModel());
        QApplication::restoreOverrideCursor();
        statusBar()->clearMessage();
        // 清理线程和工作对象
        loader->deleteLater();
        thread->quit();
        thread->wait();
        thread->deleteLater();
    });
    connect(thread, &QThread::finished, loader, &QObject::deleteLater);

    thread->start();
}

这种方式既保证了状态栏消息和等待光标立即生效，又不会阻塞主线程导致界面无响应。

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