Qt 多線程簡易方案：QtConcurrent::run 非阻塞調用耗時 API

場景痛點

GUI 主線程調用耗時同步 API（如網絡請求、複雜計算、文件壓縮）會導致界面凍結、無響應，甚至被系統判定為「未響應」而強制關閉。

最輕量解法：QtConcurrent::run + QFuture

無需繼承 QThread、無需定義 Worker 類、無需信號槽連接，三行代碼實現異步執行並獲取返回值。

核心代碼模板

// 1. 目標函數（必須為可拷貝參數，不可傳裸指針）
bool DemoDialog::threadDemo(QString arg1, QString arg2, int arg3) {
    // 耗時操作...
    return true; // 或 false 表示失敗
}

// 2. 在槽函數/事件處理中啟動異步任務
QFuture result = QtConcurrent::run(this, &DemoDialog::threadDemo, 
                                         realArgStr1, realArgStr2, realArgInt);

// 3. 非阻塞輪詢結果（保持界面響應）
while (!result.isResultReadyAt(0)) {
    QCoreApplication::processEvents(); // 關鍵：處理界面繪製/用戶輸入事件
}

// 4. 獲取結果並後續處理
if (result.result()) {
    // success
} else {
    // failed
}

關鍵注意事項

性能副作用：processEvents() 導致 CPU 佔用飆升

輪詢循環中高頻調用 processEvents() 會佔滿 CPU 核心。優化方案：

• 引入 QThread::msleep(10~50) 降低輪詢頻率
• 改用 QFutureWatcher + 信號槽（finished()）實現真正事件驅動，避免忙等
• 或直接用 QtConcurrent::run 配合 QFuture::then() (C++17/Qt6) 鏈式回調

進階替代方案對比

總結

QtConcurrent::run 是 Qt 多線程的「瑞士軍刀」——輕量、直觀、適合 80% 的簡單異步需求。但切記：參數傳值、輪詢加睡眠、複雜場景轉正規 QThread。