Qt 6.11 与 C++20：现代 GUI 开发实践

Qt 6.11 与 C++20 的结合，标志着 C++ GUI 开发进入了现代化时代。本文从实战角度，梳理 Qt 框架中那些值得深入理解的设计模式与工程实践。

信号与槽：Qt 的核心机制

信号槽是 Qt 最核心的 IPC 机制，但很多人只停留在 connect() 的简单使用上。理解其底层实现，才能写出高性能的 Qt 程序。

元对象编译器 (MOC)

Qt 的 Q_OBJECT 宏并不是魔法——它触发 MOC 生成额外的 C++ 代码：

// 编译前：mywidget.h
class MyWidget : public QWidget {
    Q_OBJECT
signals:
    void dataReady(const QString& data);
};

// MOC 生成（简化）：moc_mywidget.cpp
const QMetaObject MyWidget::staticMetaObject = {
    { &QWidget::staticMetaObject, qt_meta_stringdata_MyWidget.data,
      qt_meta_data_MyWidget, qt_static_metacall, nullptr, nullptr }
};

MOC 的本质是一个代码生成器，它为 QObject 子类创建运行时类型信息（RTTI），使信号槽的动态连接成为可能。

连接类型与线程安全

QObject::connect() 的第 5 个参数决定了信号槽的调用方式：

连接类型	行为	适用场景
`AutoConnection`	同线程直接调用，跨线程排队	默认值，覆盖大多数场景
`DirectConnection`	发射信号的线程中立即执行	要求槽函数线程安全
`QueuedConnection`	接收者线程的事件循环中执行	跨线程通信的标准方式
`BlockingQueuedConnection`	阻塞等待槽函数执行完毕	需要同步结果的跨线程调用

// 跨线程通信的正确姿势
class Worker : public QObject {
    Q_OBJECT
public slots:
    void process(const QByteArray& data) {
        // 在工作线程中执行
        auto result = heavyComputation(data);
        emit finished(result);
    }
signals:
    void finished(const QVariant& result);
};

// UI 线程
auto* worker = new Worker;
auto* thread = new QThread(this);
worker->moveToThread(thread);
connect(thread, &QThread::finished, worker, &QObject::deleteLater);
connect(this, &MainWindow::requestProcess, worker, &Worker::process);
// 关键：跨线程用 QueuedConnection
connect(worker, &Worker::finished, this, &MainWindow::onResult,
        Qt::QueuedConnection);
thread->start();

C++20 在 Qt 中的应用

std::span 替代 QByteArray 切片

C++20 的 std::span 提供了更安全的视图语义：

// 旧方式：需要复制或手动管理指针边界
void parseHeader(const char* data, size_t size);

// C++20：类型安全的非拥有视图
void parseHeader(std::span<const uint8_t> data) {
    if (data.size() < 4) return;
    uint32_t magic = *reinterpret_cast<const uint32_t*>(data.data());
    // ...
}

// 调用处
QByteArray buffer = socket.readAll();
parseHeader(std::as_bytes(std::span{buffer.constData(), size_t(buffer.size())}));

concepts 约束模板接口

Qt 的容器广泛使用模板，C++20 concepts 可以提前发现类型错误：

#include <concepts>

template<typename T>
concept QObjectDerived = std::derived_from<T, QObject>;

template<QObjectDerived T>
auto findChildren(QObject* parent) {
    return parent->findChildren<T>(QString(), Qt::FindChildrenRecursively);
}

// 使用
auto buttons = findChildren<QPushButton>(this);        // OK
// auto ints = findChildren<int>(this);                // 编译错误！

std::jthread 与 Qt 事件循环

C++20 的 std::jthread 提供了 RAII 风格的线程管理和协作式取消：

// 用 std::jthread 实现可取消的后台任务
std::jthread backgroundTask([this](std::stop_token token) {
    while (!token.stop_requested()) {
        QThread::msleep(100);
        // 通过 QMetaObject::invokeMethod 安全回传 UI
        QMetaObject::invokeMethod(this, [this]() {
            updateProgress();
        }, Qt::QueuedConnection);
    }
    QMetaObject::invokeMethod(this, [this]() {
        onTaskFinished();
    }, Qt::QueuedConnection);
});

QWidget CSS 渲染

Qt Widgets 支持 CSS 子集进行样式定义，掌握其细节可以极大提升 UI 开发效率：

/* 类似前端开发的体验 */
QPushButton#submitBtn {
    background: #0071e3;
    color: #fff;
    border: none;
    border-radius: 8px;
    padding: 10px 24px;
    font-size: 14px;
}
QPushButton#submitBtn:hover {
    background: #0077ed;
}
QPushButton#submitBtn:pressed {
    background: #0060c0;
}

/* 自定义滚动条 */
QScrollBar:vertical {
    background: transparent;
    width: 8px;
    margin: 0;
}
QScrollBar::handle:vertical {
    background: rgba(0,0,0,0.2);
    border-radius: 4px;
    min-height: 30px;
}

构建系统：CMake 现代化

Qt 6 原生支持 CMake，告别了 qmake 的局限性：

cmake_minimum_required(VERSION 3.21)
project(ModernQtApp VERSION 1.0 LANGUAGES CXX)

set(CMAKE_CXX_STANDARD 20)
set(CMAKE_CXX_STANDARD_REQUIRED ON)
set(CMAKE_AUTOMOC ON)
set(CMAKE_AUTORCC ON)
set(CMAKE_AUTOUIC ON)

find_package(Qt6 REQUIRED COMPONENTS Widgets Network Core)

qt_add_executable(ModernQtApp
    src/main.cpp
    src/mainwindow.cpp
    src/network/client.cpp
)

target_link_libraries(ModernQtApp PRIVATE
    Qt6::Widgets
    Qt6::Network
    Qt6::Core
)

# 部署时自动处理 Qt 插件
qt_generate_deploy_app_script(
    TARGET ModernQtApp
    OUTPUT_SCRIPT deploy_script
)
install(SCRIPT ${deploy_script})

总结

理解信号槽的五种连接类型，避免跨线程访问 UI 导致的神秘崩溃
拥抱 C++20：std::span、concepts、std::jthread 让 Qt 代码更安全、更现代
Qt Widgets CSS 可以实现媲美前端框架的 UI 表现力
CMake + Qt 6 是构建系统的标准选择

好的 Qt 代码 = 扎实的 C++ 功底 + 对 Qt 框架设计哲学的深刻理解。