簡(jiǎn)介這份《QT學(xué)習(xí)之路2-2020整理版》面向希望系統(tǒng)掌握Qt框架的C開(kāi)發(fā)者與初學(xué)者基于豆子博客內(nèi)容整理并補(bǔ)全了2016年后更新的15章共94章覆蓋從環(huán)境搭建、Hello world、信號(hào)槽機(jī)制到多線程、國(guó)際化、數(shù)據(jù)庫(kù)與網(wǎng)絡(luò)編程等進(jìn)階主題。資源為單一PDF文件壓縮包約5.79MB內(nèi)容按章節(jié)編排目錄清晰便于按模塊檢索學(xué)習(xí)。目前已有870人學(xué)習(xí)下載。讀者可借此完整梳理Qt5核心知識(shí)體系理解信號(hào)槽、事件處理、布局管理、MainWindow與對(duì)話框數(shù)據(jù)傳遞等關(guān)鍵機(jī)制并借助Qt Creator使用技巧與調(diào)試方法將理論落到實(shí)際項(xiàng)目開(kāi)發(fā)中適合從入門(mén)到進(jìn)階的持續(xù)學(xué)習(xí)。1. Qt 學(xué)習(xí)之路2為什么 445 頁(yè)的教程值得逐行啃很多人第一次接觸 Qt是從拖控件開(kāi)始的。打開(kāi) Qt Creator拖幾個(gè)按鈕連一下信號(hào)槽跑起來(lái)覺(jué)得“不過(guò)如此”。但一旦遇到界面卡死、事件不響應(yīng)、多線程里對(duì)象莫名崩潰就徹底懵了。問(wèn)題的根源在于你用的是 Qt 的“表面 API”卻沒(méi)搞懂它背后的對(duì)象模型、事件循環(huán)和元對(duì)象系統(tǒng)。這份《Qt 學(xué)習(xí)之路2》2020 整理版把豆子從 2012 年到 2016 年寫(xiě)的 94 章內(nèi)容完整收進(jìn)來(lái)共 445 頁(yè)從 Hello World 一路講到線程、XML、數(shù)據(jù)庫(kù)、QML。它最大的價(jià)值不是教你“怎么調(diào) API”而是把 Qt 為什么這么設(shè)計(jì)、底層怎么跑通一層層拆開(kāi)給你看。如果你已經(jīng)會(huì)寫(xiě)幾行 Qt 代碼卻總覺(jué)得心里沒(méi)底這份資料就是幫你把地基補(bǔ)上的那塊磚。2. 信號(hào)槽為什么一個(gè) connect 能跨線程、跨對(duì)象地傳消息2.1 從函數(shù)調(diào)用到元對(duì)象信號(hào)槽不是 C 原生語(yǔ)法普通 C 函數(shù)調(diào)用編譯期就確定了地址直接跳轉(zhuǎn)就行。但信號(hào)槽不一樣你寫(xiě)connect(sender, Sender::signal, receiver, Receiver::slot)編譯時(shí)并不知道誰(shuí)會(huì)觸發(fā)、什么時(shí)候觸發(fā)、甚至接收者在不在同一個(gè)線程。Qt 能實(shí)現(xiàn)這套機(jī)制靠的是三樣?xùn)|西元對(duì)象系統(tǒng)Meta-Object System、mocMeta-Object Compiler和 QObject 的對(duì)象樹(shù)。每個(gè)繼承 QObject 并聲明Q_OBJECT宏的類moc 會(huì)為它生成一份額外的 C 代碼里面包含信號(hào)函數(shù)的實(shí)現(xiàn)、qt_metacall() 分發(fā)邏輯以及一張字符串到函數(shù)索引的映射表。信號(hào)本身沒(méi)有函數(shù)體moc 生成的代碼會(huì)調(diào)用QMetaObject::activate()由它去查連接表找到所有連到這個(gè)信號(hào)的槽然后逐個(gè)調(diào)用。常見(jiàn)的實(shí)現(xiàn)思路是QObject 內(nèi)部維護(hù)一個(gè) QObjectPrivate 結(jié)構(gòu)里面有一個(gè)connectionLists按信號(hào)索引組織。每個(gè)連接記錄發(fā)送者、接收者、槽的索引、連接類型。當(dāng)信號(hào)被激活activate()遍歷這個(gè)列表根據(jù)連接類型決定是直接調(diào)用、排隊(duì)調(diào)用還是阻塞調(diào)用。2.2 連接類型Auto、Direct、Queued 到底怎么選Qt 定義了五種連接類型最常用的是 Auto、Direct 和 Queued。Auto 是默認(rèn)值它的行為取決于發(fā)送者和接收者是否在同一個(gè)線程同線程就退化成 Direct跨線程就退化成 Queued。Direct 連接意味著槽函數(shù)在信號(hào)發(fā)出的線程里立刻執(zhí)行相當(dāng)于一次普通函數(shù)調(diào)用但多了查表開(kāi)銷。Queued 連接則把調(diào)用包裝成一個(gè) QMetaCallEvent通過(guò)QCoreApplication::postEvent()投遞到接收者所在線程的事件隊(duì)列等那個(gè)線程的事件循環(huán)處理到這個(gè)事件時(shí)再調(diào)用槽函數(shù)。這里有一個(gè)血淚經(jīng)驗(yàn)如果你在跨線程時(shí)用了 Direct槽函數(shù)會(huì)在發(fā)送者線程執(zhí)行但操作的是接收者線程的對(duì)象輕則數(shù)據(jù)競(jìng)爭(zhēng)重則直接崩潰。Qt 文檔里反復(fù)強(qiáng)調(diào)“Queued 連接參數(shù)必須是可拷貝的”就是因?yàn)閰?shù)要被復(fù)制到事件對(duì)象里等事件循環(huán)處理時(shí)再還原。// 跨線程必須用 Queued或者依賴 Auto 自動(dòng)判定 connect(workerThread, Worker::resultReady, guiObject, Gui::handleResult, Qt::QueuedConnection); // 如果寫(xiě)成 DirecthandleResult 會(huì)在 workerThread 里跑 // 此時(shí) guiObject 的成員變量可能被兩個(gè)線程同時(shí)訪問(wèn)上面代碼里Qt::QueuedConnection強(qiáng)制把調(diào)用排隊(duì)到 guiObject 所屬線程。參數(shù)resultReady攜帶的數(shù)據(jù)會(huì)被 QMetaCallEvent 拷貝一份所以自定義類型必須用qRegisterMetaType()注冊(cè)否則運(yùn)行時(shí)會(huì)報(bào) “Cannot queue arguments of type”。2.3 對(duì)象樹(shù)與線程親和性為什么 moveToThread 之后不能直接調(diào)槽QObject 有一個(gè)“線程親和性”thread affinity的概念用thread()返回它所屬的線程。默認(rèn)情況下對(duì)象屬于創(chuàng)建它的線程。moveToThread()可以改變這個(gè)歸屬但只能由當(dāng)前所屬線程調(diào)用而且不能對(duì)有父對(duì)象的對(duì)象調(diào)用——因?yàn)楦缸雨P(guān)系意味著對(duì)象樹(shù)管理跨線程移動(dòng)會(huì)破壞析構(gòu)順序。很多人踩過(guò)的坑是把 worker 對(duì)象 moveToThread 之后直接調(diào)用它的方法以為這樣就在新線程里跑了。實(shí)際上直接調(diào)用是普通函數(shù)調(diào)用還是在當(dāng)前線程執(zhí)行。只有通過(guò)信號(hào)槽Queued或QMetaObject::invokeMethod()并指定 Queued 連接才會(huì)真正切到目標(biāo)線程的事件循環(huán)里執(zhí)行。// 正確做法用 invokeMethod 排隊(duì)調(diào)用 QMetaObject::invokeMethod(worker, doWork, Qt::QueuedConnection, Q_ARG(QString, data)); // 錯(cuò)誤做法直接調(diào)還在當(dāng)前線程 worker-doWork(data); // 線程親和性沒(méi)變執(zhí)行線程也沒(méi)變invokeMethod的 Queued 模式會(huì)把方法調(diào)用包裝成事件投遞到 worker 所屬線程。參數(shù)用Q_ARG宏包裝類型必須已注冊(cè)元類型。如果方法有返回值Queued 模式下拿不到只能通過(guò)信號(hào)回傳。3. 事件循環(huán)為什么你的界面會(huì)卡死以及事件過(guò)濾器怎么救場(chǎng)3.1 QEventLoop 的本質(zhì)一個(gè)不停取事件的 while 循環(huán)Qt 程序啟動(dòng)后QApplication::exec()會(huì)進(jìn)入一個(gè)死循環(huán)不斷從事件隊(duì)列里取出事件分發(fā)給對(duì)應(yīng)的 QObject。這個(gè)循環(huán)就是 QEventLoop。每個(gè)線程可以有自己的事件循環(huán)GUI 線程的事件循環(huán)由 QApplication 啟動(dòng)工作線程可以用QThread::exec()啟動(dòng)。事件的分發(fā)路徑是QCoreApplication::notify()→QObject::event()→ 具體的事件處理函數(shù)如mousePressEvent()。notify()是虛函數(shù)可以重寫(xiě)但更常見(jiàn)的做法是裝事件過(guò)濾器。界面卡死的根本原因通常是你在 GUI 線程里干了耗時(shí)的事——比如讀一個(gè)大文件、等網(wǎng)絡(luò)響應(yīng)、跑復(fù)雜計(jì)算。事件循環(huán)被你的代碼占住沒(méi)法取下一個(gè)事件界面自然不刷新。解決思路只有兩個(gè)把耗時(shí)操作挪到工作線程或者在耗時(shí)操作里手動(dòng)調(diào)用QCoreApplication::processEvents()讓事件循環(huán)喘口氣。后者是權(quán)宜之計(jì)容易引發(fā)重入問(wèn)題不推薦。3.2 事件過(guò)濾器在 event() 之前截胡事件過(guò)濾器event filter是一個(gè) QObject通過(guò)installEventFilter()裝到目標(biāo)對(duì)象上。當(dāng)目標(biāo)對(duì)象收到事件時(shí)QCoreApplication::notify()會(huì)先調(diào)用過(guò)濾器的eventFilter()函數(shù)。如果返回 true事件就被吃掉不再往下傳返回 false繼續(xù)正常分發(fā)。這個(gè)機(jī)制常用來(lái)做全局快捷鍵、鼠標(biāo)懸停預(yù)覽、輸入框內(nèi)容實(shí)時(shí)校驗(yàn)。比如你想讓某個(gè) QLineEdit 只接受數(shù)字可以裝一個(gè)過(guò)濾器在 KeyPress 事件到達(dá)輸入框之前攔截非數(shù)字鍵。bool NumericFilter::eventFilter(QObject *watched, QEvent *event) { if (event-type() QEvent::KeyPress) { auto *keyEvent static_castQKeyEvent *(event); if (keyEvent-key() Qt::Key_0 || keyEvent-key() Qt::Key_9) { return true; // 吃掉非數(shù)字鍵 } } return QObject::eventFilter(watched, event); // 放行 }watched是裝過(guò)濾器的目標(biāo)對(duì)象event是待處理事件。返回 true 表示“已處理別再往下走”。注意過(guò)濾器對(duì)象本身必須活得比目標(biāo)對(duì)象久否則目標(biāo)對(duì)象析構(gòu)時(shí)可能訪問(wèn)懸空指針。3.3 自定義事件與 sendEvent/postEvent 的區(qū)別Qt 允許你定義自己的事件類型繼承 QEvent用一個(gè)大于QEvent::User的枚舉值。發(fā)送自定義事件有兩種方式sendEvent()同步發(fā)送事件立刻被處理相當(dāng)于直接調(diào)用notify()postEvent()異步發(fā)送事件被放進(jìn)隊(duì)列等事件循環(huán)下一輪再處理。同步發(fā)送適合需要立刻拿到結(jié)果的場(chǎng)景但要注意重入——如果接收者在處理事件時(shí)又發(fā)了同樣的事件可能無(wú)限遞歸。異步發(fā)送更安全但事件對(duì)象必須用new分配在堆上Qt 處理完后會(huì)自動(dòng) delete你不能手動(dòng)刪。// 自定義事件類型 class MyEvent : public QEvent { public: MyEvent(const QString msg) : QEvent(static_castQEvent::Type(QEvent::User 1)), m_msg(msg) {} QString message() const { return m_msg; } private: QString m_msg; }; // 異步發(fā)送事件對(duì)象由 Qt 管理 QCoreApplication::postEvent(receiver, new MyEvent(hello));postEvent之后事件對(duì)象的所有權(quán)轉(zhuǎn)移給 Qt你不能再碰它。接收者重寫(xiě)customEvent()來(lái)處理或者重寫(xiě)event()做更通用的分發(fā)。4. 避坑與排查信號(hào)槽、事件、線程里最容易翻車的幾個(gè)點(diǎn)4.1 信號(hào)槽連接成功但槽不執(zhí)行現(xiàn)象connect返回 true編譯運(yùn)行都沒(méi)報(bào)錯(cuò)但槽函數(shù)死活不進(jìn)。原因最常見(jiàn)的是接收者對(duì)象在信號(hào)發(fā)出前已經(jīng)被析構(gòu)Qt 會(huì)自動(dòng)斷開(kāi)連接但如果你用的是函數(shù)指針語(yǔ)法且對(duì)象已銷毀行為未定義。另一個(gè)原因是連接類型是 Queued但接收者線程沒(méi)有事件循環(huán)事件永遠(yuǎn)排隊(duì)沒(méi)人處理。解決檢查接收者是否還活著用QPointer或QObject::isSignalConnected()確認(rèn)。如果是跨線程 Queued確保接收者線程調(diào)用了exec()或QThread::run()里有事件循環(huán)。4.2 在槽函數(shù)里 delete 發(fā)送者導(dǎo)致崩潰現(xiàn)象槽函數(shù)執(zhí)行到一半程序段錯(cuò)誤。原因信號(hào)發(fā)出后Qt 會(huì)遍歷連接列表調(diào)用槽。如果某個(gè)槽把發(fā)送者 delete 了后續(xù)槽再訪問(wèn)發(fā)送者就是野指針。Direct 連接下這個(gè)問(wèn)題尤其明顯。解決用deleteLater()代替delete。deleteLater()會(huì)投遞一個(gè) DeferredDelete 事件等當(dāng)前事件循環(huán)回到最外層時(shí)才真正析構(gòu)保證所有槽都執(zhí)行完。4.3 moveToThread 之后定時(shí)器不觸發(fā)現(xiàn)象QTimer 在 moveToThread 之后不走了。原因QTimer 依賴事件循環(huán)。如果對(duì)象被移到新線程但新線程沒(méi)有啟動(dòng)事件循環(huán)沒(méi)調(diào)exec()定時(shí)器事件沒(méi)人處理。解決在 QThread 的run()里調(diào)用exec()或者用QThread::started信號(hào)連接到工作對(duì)象的初始化槽確保事件循環(huán)先跑起來(lái)。4.4 事件過(guò)濾器返回 true 導(dǎo)致界面無(wú)響應(yīng)現(xiàn)象裝了事件過(guò)濾器后某個(gè)控件完全點(diǎn)不動(dòng)。原因eventFilter()里對(duì)所有事件都返回了 true把鼠標(biāo)、鍵盤(pán)事件全吃了。解決只攔截你關(guān)心的事件類型其余一律返回QObject::eventFilter(watched, event)。不要圖省事直接return true。4.5 跨線程信號(hào)槽傳自定義類型報(bào)錯(cuò)現(xiàn)象運(yùn)行時(shí)報(bào) “Cannot queue arguments of type MyType”。原因Queued 連接需要把參數(shù)拷貝到事件對(duì)象里Qt 必須知道怎么構(gòu)造、析構(gòu)、拷貝這個(gè)類型。自定義類型默認(rèn)沒(méi)注冊(cè)元類型。解決在main()里或類定義后調(diào)用qRegisterMetaTypeMyType(MyType)并且 MyType 要有默認(rèn)構(gòu)造函數(shù)、拷貝構(gòu)造函數(shù)和析構(gòu)函數(shù)。5. 從 94 章到工程實(shí)踐怎么用這份資料把 Qt 底層吃透這份 445 頁(yè)的資料章節(jié)編排本身就是一條從表層到底層的路徑。前 15 章講基礎(chǔ)控件和信號(hào)槽用法第 16 章“深入 Qt5 信號(hào)槽新語(yǔ)法”開(kāi)始往元對(duì)象系統(tǒng)里鉆第 18 到 23 章集中講事件機(jī)制第 71 到 75 章把線程和 QObject 的關(guān)系徹底攤開(kāi)。如果你只是順著讀很容易停在“會(huì)用”的層面。更有效的方式是每讀到一個(gè)機(jī)制就自己寫(xiě)一個(gè)最小復(fù)現(xiàn)然后故意制造錯(cuò)誤看 Qt 報(bào)什么、怎么崩。比如讀到“隱式數(shù)據(jù)共享”那一章你可以寫(xiě)一個(gè) QString用constData()拿指針然后拷貝一份修改原對(duì)象觀察指針地址變不變。Qt 的隱式共享用引用計(jì)數(shù)實(shí)現(xiàn)拷貝時(shí)只增計(jì)數(shù)寫(xiě)時(shí)才真正復(fù)制copy-on-write。這個(gè)機(jī)制在容器類里普遍存在理解它能幫你避開(kāi)大量無(wú)謂的性能損耗。再比如 model/view 架構(gòu)第 41 到 50 章用了大量篇幅。很多人覺(jué)得 model/view 比 QTableWidget 麻煩不如直接填表格。但當(dāng)你需要展示十萬(wàn)行數(shù)據(jù)、還要排序過(guò)濾時(shí)QTableWidget 會(huì)直接卡死而 QAbstractItemModel 配合 QSortFilterProxyModel 可以做到只渲染可見(jiàn)區(qū)域。這份資料把自定義只讀模型、可編輯模型、布爾表達(dá)式樹(shù)模型都拆了一遍跟著寫(xiě)一遍基本就能掌握 model/view 的骨架。最后一章落到設(shè)計(jì)取舍上。Qt 的信號(hào)槽比普通函數(shù)調(diào)用慢大約一個(gè)數(shù)量級(jí)這是 Qt 4 文檔里明確寫(xiě)的。但換來(lái)的是解耦和跨線程安全。你在做高頻交易系統(tǒng)或?qū)崟r(shí)渲染時(shí)可能得避開(kāi)信號(hào)槽直接用回調(diào)或虛函數(shù)。但在常規(guī)桌面應(yīng)用里這點(diǎn)開(kāi)銷完全可以接受。Qt 的跨平臺(tái)策略是 GUI 模擬不是 API 映射所以它的界面不是原生風(fēng)格但換來(lái)了外觀的高度可定制。這些取舍沒(méi)有絕對(duì)的對(duì)錯(cuò)只有場(chǎng)景匹配。我自己的習(xí)慣是每次接手一個(gè) Qt 項(xiàng)目先看它的線程模型和事件循環(huán)怎么組織的再看信號(hào)槽連接類型有沒(méi)有用錯(cuò)。從那以后我每次寫(xiě)跨線程代碼都強(qiáng)制走一遍moveToThreadQueuedConnectionqRegisterMetaType三件套再也沒(méi)遇到過(guò)玄學(xué)崩潰。希望這份資料也能幫你把 Qt 的底層邏輯理清楚少踩幾個(gè)坑。本文還有配套的精品資源點(diǎn)擊獲取