真正安全可维护的方式是用 QObject 子类当 Worker，通过 moveToThread() 绑定并以信号槽驱动执行；继承 QThread 重写 run() 易导致跨线程调用崩溃、UI 卡顿及生命周期错误。
别继承 QThread 写 run()，那是最容易崩、最难调试的写法。真正安全可维护的方式是：用普通 QObject 子类当 Worker，moveToThread() 绑定，靠信号槽驱动执行。
为什么继承 QThread::run() 会出问题
你写的 run() 确实在子线程里运行，但这个类的其他成员（比如槽函数、普通方法、成员变量）全在主线程上下文里。一旦你在 run() 里调用另一个成员函数，或者 connect 了某个槽却没指定连接类型，Qt 就可能跨线程直接调用——轻则 UI 不更新、进度卡住，重则 QObject: Cannot create children for a parent that is in a different thread 或野指针崩溃。
更隐蔽的问题是：QThread 对象本身生命周期必须严格管理。如果 WorkerThread 是栈对象或没正确 deleteLater()，就容易触发 QThread: Destroyed while thread is still running。
-
run()里不能 emit 主线程 UI 相关信号（如更新QLabel）——必须走信号槽，且要确保连接类型是Qt::QueuedConnection - 不能在
run()中调用QObject的任何非const成员函数（除非你手动加锁） -
QThread对象析构前必须确保isFinished()为true，否则 Qt 会 abort
moveToThread 模式怎么写才不翻车
核心就三步：构造 Worker、创建 QThread、移动并连接。但每步都有关键细节：
- Worker 必须继承
QObject，且所有耗时逻辑写在public slots:函数里（比如doWork()），不能是普通成员函数 -
worker->moveToThread(thread)必须在thread->start()之前调用；调换顺序会导致对象仍留在主线程 - 连接必须显式使用
Qt::QueuedConnection（尤其跨线程发信号给主线程槽），避免默认AutoConnection在 debug 下误判成 direct - 线程退出后，务必让
worker和thread自动清理：connect(worker, &Worker::finished, worker, &Worker::deleteLater)+connect(thread, &QThread::finished, thread, &QThread::deleteLater)
示例关键片段：
QThread *thread = new QThread(this); Worker *worker = new Worker(); worker->moveToThread(thread); connect(thread, &QThread::started, worker, &Worker::doWork, Qt::QueuedConnection); connect(worker, &Worker::progress, this, &MainWindow::onProgress, Qt::QueuedConnection); connect(worker, &Worker::finished, thread, &QThread::quit); connect(worker, &Worker::finished, worker, &Worker::deleteLater); connect(thread, &QThread::finished, thread, &QThread::deleteLater); thread->start();
信号传参有哪些硬限制
跨线程信号参数必须能被 Qt 元对象系统序列化。常见坑：
- 自定义结构体/类必须先注册：
qRegisterMetaType<MyStruct>("MyStruct")，且提供QMetaObject::registerComparators（如需比较） - 不能传裸指针（如
MyClass*），会被复制为空或悬空；应传QSharedPointer<MyClass>或QVariant包装 - PyQt5/PySide6 中，信号声明必须带类型（如
result_ready = pyqtSignal(str, int)），否则传参类型错乱时不会报错，只静默失败 - 大对象（如
QImage、QByteArray）跨线程传递会触发深拷贝，频繁传图建议用QSharedMemory或只传路径
线程退出和取消怎么做到真正安全
用户点“取消”时，不能粗暴 terminate() —— 这会跳过析构、泄漏文件句柄、破坏数据一致性。正确做法是：
- Worker 内部设一个
volatile bool m_cancelRequested = false，并在耗时循环中定期检查：if (m_cancelRequested) return; - 主线程通过信号通知取消：
connect(cancelButton, &QPushButton::clicked, worker, &Worker::requestCancel)，槽里置位标志 - 不要依赖
QThread::isInterruptionRequested()，它只对exec()有效；你的doWork()是普通函数，得自己轮询 - 退出前确保所有资源关闭：文件、数据库连接、网络 socket 都要在
worker的析构函数或finished槽里 clean up
最后提醒一句：moveToThread() 后，Worker 对象的事件循环并不自动启动——除非你手动调用 thread->exec()。绝大多数场景下，你只需要靠信号触发一次 doWork()，做完就 quit，不需要长期驻留事件循环。
