這次我們來看一套“重學(xué) QT”體系里的第 02 章常用控件14 講。整個章節(jié)配套視頻、源碼和詳細(xì)筆記學(xué)習(xí)方式強(qiáng)調(diào)“從零一行行寫代碼”不是打開 Qt Designer 拖兩個控件就完事。這個定位值得單獨(dú)拿出來講很多 Qt 開發(fā)者的真實(shí)狀態(tài)不是不會用 QPushButton而是對 QPushButton 背后的父子對象、布局策略、信號槽類型匹配和事件循環(huán)沒有形成完整的知識閉環(huán)?？丶?Qt 桌面開發(fā)的入口也是后面做串口、圖表、多線程、網(wǎng)絡(luò)通信這些實(shí)戰(zhàn)項(xiàng)目時必須反復(fù)使用的一層。把這一章啃透比急著去學(xué) Model/View 或者 QML 更劃算。先說結(jié)論如果你正在準(zhǔn)備 Qt 面試、要維護(hù)老 QWidget 項(xiàng)目、或者用 Qt 做上位機(jī)但只能照抄 demo這一章建議整章重過一遍如果你是零基礎(chǔ)且 C 語法還不熟先把指針、引用、const、lambda 基礎(chǔ)補(bǔ)一補(bǔ)再進(jìn)來。文章會按照“先看環(huán)境能不能跑、再用最小代碼驗(yàn)證控件、最后按清單排查問題”的順序展開盡量把 14 講里最容易翻車的幾個點(diǎn)說清楚。正文比較長建議先收藏。1. 常用控件章節(jié)核心信息速覽項(xiàng)目說明章節(jié)定位重學(xué) QT 基礎(chǔ)篇第 02 章承接第 01 章環(huán)境與基礎(chǔ)進(jìn)入控件實(shí)戰(zhàn)課時體量常用控件共 14 講每講圍繞一組 Qt Widgets 控件展開課程資料視頻教程、配套源碼、詳細(xì)筆記代碼方式從零一行行寫代碼不是直接用 Designer 拖拽主要功能QWidget 常用控件創(chuàng)建、屬性設(shè)置、信號槽關(guān)聯(lián)、布局組合適合平臺Windows、Linux 下 Qt Widgets 桌面應(yīng)用硬件要求普通 CPU 電腦即可最好能裝 Qt Creator語法基礎(chǔ)需要 C 基礎(chǔ)至少會用類、指針、虛函數(shù)、lambda延續(xù)方向信號槽機(jī)制、布局管理、樣式表、Model/View、多線程 UI 更新、QCustomPlot/QChart 繪圖先說一個容易誤判的點(diǎn)14 講不代表只有 14 個控件。Qt 基礎(chǔ)控件數(shù)量很多課程更常見的組織方式是把同族控件放在一起講比如 QLineEdit 和 QTextEdit 都是文本輸入QRadioButton、QCheckBox、QPushButton 都屬于按鈕族。學(xué)的時候要看懂基類和派生類的關(guān)系而不是孤立地記每個類的 API。下面給出的學(xué)習(xí)路徑和驗(yàn)證清單也建議按這個思路去套不必逐行背文檔。視頻、源碼、筆記三者怎么分配優(yōu)先級新手最容易犯的錯是只看視頻不動手。14 講的節(jié)奏合適哪怕每講只有十幾分鐘也建議每講結(jié)束后關(guān)掉視頻對照筆記里的目標(biāo)從零寫一遍核心代碼。源碼不是用來直接打開的是用來做“最后對照”的。這樣一套流程下來代碼量不多但是每個控件都過了一遍真實(shí)使用場景后面遇到問題也更容易定位是布局問題、信號槽問題還是控件生命周期問題。2. 為什么要“重學(xué)”而不是“初學(xué)”控件很多 Qt 教程講控件只講一句“創(chuàng)建一個按鈕然后 connect 它的 clicked 信號”但你在真實(shí)項(xiàng)目里會立刻碰到幾個追問這個按鈕是 new 出來還是放在棧上要不要傳 parent如果不傳 parent按鈕關(guān)閉后會不會內(nèi)存泄漏按鈕被 Layout 接管之后布局對象和父窗口誰負(fù)責(zé)刪除這些問題在“用 CtrlC、CtrlV 寫 Qt”的時候不會暴露一旦自己從零構(gòu)建一個窗口馬上就會卡住。第 02 章強(qiáng)調(diào)從零一行行寫代碼本質(zhì)是在逼你建立自己的控件知識結(jié)構(gòu)。一個控件從生到死至少要過這幾步構(gòu)造時可以傳 parent但也可以在后續(xù)任意時刻 reparent設(shè)置屬性前要想清楚是字符串、數(shù)值還是枚舉addWidget 布局后控件尺寸由 layout 管理控件要被 show 或者被父窗口帶入顯示狀態(tài)控件發(fā)出 clicked、textChanged、currentIndexChanged 等信號時對應(yīng)的槽函數(shù)要在正確的對象和線程里執(zhí)行窗口銷毀時子控件會被遞歸銷毀但是如果控件沒有父對象就必須自己保證釋放。Qt 控件的類層級也值得重新看一遍。QPushButton、QToolButton、QRadioButton、QCheckBox 都繼承自 QAbstractButton而 QAbstractButton 又繼承 QWidget。只要理解了 QAbstractButton 提供了 setText、setIcon、click、setCheckable 這些公共能力和 clicked、pressed、released、toggled 這些信號后面遇到任何“按鈕類控件”都會自動聯(lián)想過去。同理QListWidget、QTableWidget、QTreeWidget 雖然形態(tài)差別很大實(shí)際上都建立在 item widget 的模型之上。先掌握基類再區(qū)分派生類差異是效率最高的學(xué)習(xí)路徑。從面試角度說控件也是 Qt 開發(fā)最容易被細(xì)問的地方。面試官很少問“QLabel 的構(gòu)造函數(shù)會傳入 parent 嗎”但如果聊你做過多少個窗口大概率會問怎么動態(tài)生成一組按鈕、怎么在一個界面里嵌套多個 QTabWidget、表格里成百上千行數(shù)據(jù)為什么卡、信號槽斷開怎么做、線程里能不能直接改 QLabel 文本。這些問題不會只考“認(rèn)識某個控件”而是考控件背后的對象模型和事件循環(huán)。第 02 章把控件本身的基礎(chǔ)打牢后面很多問題都能追回到這一章。3. 適用場景與學(xué)習(xí)邊界不是所有人都需要以這一章為主路線。第 02 章適合四類讀者第一C 基礎(chǔ)還行但 Qt 經(jīng)驗(yàn)基本靠復(fù)制 demo現(xiàn)在需要獨(dú)立承擔(dān)窗口模塊第二做工業(yè)上位機(jī)或桌面工具的開發(fā)界面主要是 QWidget/QDialog需要把控件用得更規(guī)范第三準(zhǔn)備系統(tǒng)補(bǔ) Qt 基礎(chǔ)的面試者希望把常用控件、信號槽、源碼結(jié)構(gòu)串成完整知識線第四要帶新人、寫內(nèi)部培訓(xùn)資料的技術(shù)負(fù)責(zé)人可以參考 14 講結(jié)構(gòu)做練習(xí)清單。如果不滿足前提建議先不要碰這章完全不會 C 的讀者先補(bǔ)變量、類、繼承、指針、STL 基礎(chǔ)再回來看目標(biāo)是 QML/Qt Quick 移動端或嵌入式 HMI 的讀者Widgets 控件雖然能輔助理解概念但主路線應(yīng)轉(zhuǎn)向 QML 類型系統(tǒng)只想做一次性小工具、不考慮工程維護(hù)的讀者用 Designer 拖拽確實(shí)更快這章的方法是幫你建立長期可維護(hù)能力短期看“性價(jià)比”反而不高。還要說明一個邊界第 02 章是控件使用不包含完整的自定義控件繪制體系。如果要做炫酷皮膚、重繪儀表盤、地圖軌跡、時域波形圖還需要后續(xù)的 QPainter、QPen/QBrush、事件重寫和 QCustomPlot/QChart 專題。常用控件這一層解決的是“窗口搭得出來”但一個窗口的視覺細(xì)節(jié)、動畫流暢度、超大列表性能屬于圖形繪制和 Model/View 優(yōu)化問題。學(xué)完這章不要誤以為自己已經(jīng)把 Qt 圖形全部掌握了。合規(guī)邊界的提醒也要放在前面。無論項(xiàng)目用視頻里的源碼還是自己寫的控件邏輯如果涉及真實(shí)業(yè)務(wù)系統(tǒng)都要檢查 Qt 開源版協(xié)議、源碼依賴庫的許可證以及最終產(chǎn)品是否需要開源。Qt 按 LGPL 等協(xié)議使用時通常需要允許用戶替換 Qt 庫具體條款要按照實(shí)際版本和商用方式確認(rèn)。此外把控件用于工控或數(shù)據(jù)采集界面時嚴(yán)禁直接連接未經(jīng)授權(quán)的內(nèi)網(wǎng)資源凡是涉及他人文本、圖片、字體、圖標(biāo)素材的都要確保有授權(quán)。4. 環(huán)境準(zhǔn)備把 Qt 跑通再談控件這章說的“環(huán)境”不復(fù)雜但對新手來說一個明顯問題是看視頻時講師用的版本和本地不一致導(dǎo)致 API 明明一樣編譯卻各種報(bào)錯。Qt 5 和 Qt 6 都支持 QWidget 常用控件常用控件 API 多數(shù)兼容但 CMake 配置方式、高 DPI 默認(rèn)行為、部分頭文件位置有差異。視頻配套源碼基于哪個版本最好先看筆記里的要求。沒有明確說明時我建議 Qt 5.15.2 或 Qt 6.5 之后的 LTS 版本都可以二選一后盡量保持一致。安裝 Qt 工具鏈時要關(guān)注的不是“默認(rèn)下一步”而是組件勾選。使用 Qt Widgets 應(yīng)用至少需要當(dāng)前平臺的編譯器支持Windows 常用 MSVC 或 MinGWLinux 用 GCC。安裝 Qt 時把對應(yīng)編譯器套件、Qt Debugger、Qt Creator、Sources 勾上寧可磁盤多占幾 GB也不要等到編譯時才發(fā)現(xiàn)缺少 Symbols 或調(diào)試器。初學(xué)者最怕的報(bào)錯“could not find the qt platform plugin windows”“qt.qpa.plugin: could not load the Qt platform plugin”通常不是控件代碼問題而是環(huán)境沒有配對。先做一個不依賴任何自定義控件的空白窗口。新建項(xiàng)目時選 Qt Widgets Application也可以手動建立目錄和源文件。最簡單的 main.cpp#include QApplication #include QLabel int main(int argc, char *argv[]) { QApplication app(argc, argv); QLabel label(控件章節(jié)環(huán)境驗(yàn)證); label.resize(320, 120); label.show(); return app.exec(); }.pro 工程文件可以很簡單QT widgets CONFIG c17 TARGET env_check TEMPLATE app SOURCES main.cpp如果使用 CMakeQt 6 的基礎(chǔ) CMakeLists.txt 可以這樣寫cmake_minimum_required(VERSION 3.16) project(env_check LANGUAGES CXX) set(CMAKE_CXX_STANDARD 17) set(CMAKE_CXX_STANDARD_REQUIRED ON) set(CMAKE_AUTOMOC ON) find_package(Qt6 REQUIRED COMPONENTS Widgets) qt_add_executable(env_check main.cpp) target_link_libraries(env_check PRIVATE Qt6::Widgets)編譯成功并彈出窗口說明 qmake/CMake、編譯器、Qt 庫、插件鏈已經(jīng)通了。如果運(yùn)行后沒有窗口而是報(bào)錯可以先檢查兩個方向構(gòu)建時用的 Kit 是否和安裝的 Qt 編譯器一致程序運(yùn)行時是否能找到 Qt 的 plugins 目錄。開發(fā)環(huán)境下Qt 的 bin 和 plugins 路徑通常已經(jīng)寫入安裝器如果手動拷貝 exe 到別的目錄運(yùn)行就要用 windeployqt 把 Qt 運(yùn)行庫和 platforms 目錄帶過去。5. 從零一行行寫代碼每講最好這樣拆解第 02 章有 14 講如果用屏幕看視頻會看到講師在代碼編輯器里從空文件開始敲。很多人誤以為這種演示只是“為了顯得認(rèn)真”實(shí)際上這是一個很高效的拆解法不要一次寫整個窗口也不要直接在 Qt Creator 里用雙擊生成 UI 文件。正確方式是把每一講的大目標(biāo)拆成小步每步能看到編譯和運(yùn)行結(jié)果。以按鈕和文本輸入為例可以把一個簡單聯(lián)動拆成幾步第一步創(chuàng)建 QWidget 作為主窗口第二步放一個 QPushButton、一個 QLineEdit、一個 QLabel第三步設(shè)置水平和垂直布局明確控件在窗口縮放時的伸縮行為第四步連接按鈕的 clicked 信號讓 QLabel 顯示 QLineEdit 當(dāng)前文本第五步編譯運(yùn)行驗(yàn)證點(diǎn)擊效果第六步再增加邊界情況比如輸入為空時提示或者禁用按鈕。每一步都是可以運(yùn)行的而不是寫完一個幾百行的文件再去找錯誤。為什么強(qiáng)調(diào)一行行寫代碼而不是直接使用 Designer因?yàn)?Designer 生成的 .ui 最后也會編譯成代碼但控件之間的 parent、objectName、layout 關(guān)系被可視化了你容易失去對“代碼如何組織”的敏感。運(yùn)行期動態(tài)創(chuàng)建控件時沒有 .ui 幫你管理父子關(guān)系、信號槽、布局層級都必須寫清楚。先練習(xí)純代碼之后再學(xué) .ui 才能真正理解 UI 文件是怎么工作的。反過來如果你已經(jīng)熟練 Designer也建議在工程里查看 ui_xxx.h 里生成的 setupUi 函數(shù)這比任何教程都更能還原控件代碼結(jié)構(gòu)。再給一個純代碼的練習(xí)模板。目標(biāo)是用 QSlider 控制 QLabel 顯示數(shù)字看控件之間的數(shù)值聯(lián)動#include QApplication #include QWidget #include QSlider #include QLabel #include QVBoxLayout int main(int argc, char *argv[]) { QApplication app(argc, argv); QWidget window; window.setWindowTitle(Slider 到 Label 聯(lián)動); QSlider *slider new QSlider(Qt::Horizontal); slider-setRange(0, 100); slider-setValue(30); QLabel *label new QLabel(30); label-setAlignment(Qt::AlignCenter); // QSlider::valueChanged 不存在重載寫法最穩(wěn) QObject::connect(slider, QSlider::valueChanged, label, [label](int value) { label-setText(QString::number(value)); }); QVBoxLayout *layout new QVBoxLayout(window); layout-addWidget(slider); layout-addWidget(label); window.show(); return app.exec(); }這段代碼正確連接到 label但只有當(dāng)你確認(rèn)了 QSlider 的 valueChanged 參數(shù)是 int 之后才敢這么寫。如果換成 QSpinBox它的 valueChanged 信號在 Qt 中有重載直接用 QSpinBox::valueChanged 作為函數(shù)指針會出現(xiàn)歧義。課程在講“一行行寫代碼”時這類細(xì)節(jié)就是最容易暴露基礎(chǔ)是否牢固的地方。配套源碼到手之后不要先急著全看。每講源碼可能有多個文件先只看 main.cpp 或單個 widget 的實(shí)現(xiàn)看懂它創(chuàng)建了哪幾個控件、每個控件構(gòu)造函數(shù)里的 parent 是誰、哪些控件被 addWidget 了、connect 的發(fā)送者和接收者是誰。如果能在不看源碼的情況下自己復(fù)現(xiàn)同一邏輯再去對照源碼差異點(diǎn)就是這講最值得重點(diǎn)理解的坑。6. 常用控件的學(xué)習(xí)地圖與驗(yàn)證清單第 02 章 14 講如何分配沒有統(tǒng)一答案但常用控件通常會被劃分為顯示類、按鈕類、文本輸入類、數(shù)值輸入類、列表表格樹類、容器和窗口結(jié)構(gòu)類。每一類抓的核心點(diǎn)不一樣學(xué)習(xí)時用的驗(yàn)證方法也不一樣。顯示類控件中QLabel 最典型常用屬性是 text、alignment、wordWrap還有 pixmap 顯示圖片信號比較少主要靠外部代碼改變它的內(nèi)容。學(xué)習(xí) QLabel 的時候要重點(diǎn)驗(yàn)證“文本變化后布局如何更新”“長文本不換行會怎樣”“圖片和縮放模式怎么配合”。QProgressBar 可以歸入顯示與反饋它一般依賴外部代碼更新 value適合在后續(xù)多線程任務(wù)里使用。按鈕類控件以 QPushButton、QRadioButton、QCheckBox、QToolButton 為代表。它們都能通過 setText、setIcon 設(shè)置界面setEnabled 控制可用性。QPushButton 最常用 clickedQRadioButton 和 QCheckBox 則適合用到 toggled 信號。做驗(yàn)證的時候可以把三個按鈕放到 QButtonGroup 里觀察單選和互斥行為能不能符合預(yù)期。文本輸入類控件要分開對待。QLineEdit 是單行輸入學(xué)習(xí)重點(diǎn)包括 placeholderText、setEchoMode用它做密碼框、搜索框很常見QTextEdit 是多行富文本編輯器它可以展示純文本、HTML 或 Markdown實(shí)踐項(xiàng)目里也大量用來顯示串口日志、聊天記錄、文本日志。這里最容易出問題的是“輸入事件觸發(fā)頻率”。在 QLineEdit 的 textChanged 信號里做每次按鍵處理槽函數(shù)會很頻繁執(zhí)行所以要掌握什么時候用 editingFinished什么時候用 textChanged。數(shù)值輸入類控件中QSpinBox、QDoubleSpinBox、QSlider、QDateTimeEdit 都很常用。QSpinBox 與 QSlider 經(jīng)常做聯(lián)動用來設(shè)置電機(jī)速度、音量、閾值等參數(shù)。QDateTimeEdit 在項(xiàng)目中常與 QCalendarWidget 配合用來做日期區(qū)間選擇。學(xué)到這里可以嘗試做一個“參數(shù)設(shè)置區(qū)”用 QSpinBox 設(shè)置數(shù)量用 QSlider 快速拖拽同時用一個 QLabel 實(shí)時顯示最終值這比單獨(dú)練習(xí)一個控件更有用。列表表格樹類控件是很多工程軟件的界面核心。QListWidget 適合簡單列表QTreeWidget 適合樹形結(jié)構(gòu)QTableWidget 適合行列表格。它們的快速 demo 都不難addItem、setItem、setCellWidget、currentRow 這些基礎(chǔ) API 很容易上手。但工程里會出現(xiàn)大量行的列表這時只靠 item widget 會卡頓之后需要了解 Model/View 和自定義委托。第 02 章如果只要求“能用”你至少要知道 QTableWidget 的行列、表頭和 item 選擇怎么取如果要處理幾十萬行那不能停留在 item widget要往 QTableView 和 QAbstractTableModel 方向走。容器類和窗口結(jié)構(gòu)類包括 QGroupBox、QTabWidget、QSplitter、QScrollArea、QMenuBar/QToolBar/QStatusBar。它們的核心作用是組織界面。驗(yàn)證時重點(diǎn)看兩件事加入子控件后布局是否替換、窗口拉伸時容器內(nèi)部的控件到底按什么策略變化。QGroupBox 可以給一組單選按鈕提供分組邊界QTabWidget 用來切頁QScrollArea 可以包住超出可視區(qū)域的內(nèi)容。只看單個控件外觀不夠必須拖到整體布局里去驗(yàn)證。每講學(xué)完不要靠感覺判斷“會了”可以用下面的問題自查控件你會不會寫這些QPushButton/QRadioButton/QCheckBoxsetText、setEnabled、clicked、toggled、QButtonGroup 分組QLineEdit/QTextEdittext、placeholderText、echoMode、textChanged、多行日志顯示QComboBoxaddItem、currentIndexChanged、setEditable、獲取當(dāng)前文本QSpinBox/QSlidersetRange、setValue、valueChanged、數(shù)值聯(lián)動QListWidget/QTableWidget/QTreeWidget增刪條目、讀取當(dāng)前選中項(xiàng)、表頭設(shè)置QTabWidget/QGroupBox/QSplitter動態(tài)加頁、嵌套布局、拉伸比例QProgressBar/QLabel進(jìn)度更新、文本/圖片顯示、樣式表改變外觀更直接的辦法是反過來做題給一個需求不給控件名讓你選擇用什么控件。要求“下拉選一個方案右側(cè)顯示對應(yīng)說明文字”你要想到 QComboBox QStackedWidget要求“左側(cè)分類樹、右上詳細(xì)表格、右下日志”你要想到 QTreeWidget QTableWidget QTextEdit 加 QSplitter。這種“需求到控件”的映射能力才是 14 講練完之后留下來的能力。7. 信號槽是控件練習(xí)里最繞的一環(huán)把常用控件練得差不多后最大的難點(diǎn)就集中在信號槽上?？丶旧碇皇恰皫Ы缑娴膶ο蟆闭嬲尳缑鎰悠饋淼氖切盘柌邸５?02 章雖然主題是控件但每講都脫離不了 connect所以要提前把信號槽的基礎(chǔ)用法摸清。新版 Qt 推薦使用函數(shù)指針語法因?yàn)樗诰幾g期就能檢查信號和槽是否存在類型不匹配會直接報(bào)錯。比如連接按鈕點(diǎn)擊和窗口關(guān)閉connect(button, QPushButton::clicked, this, QWidget::close);如果槽函數(shù)帶參數(shù)信號參數(shù)必須能轉(zhuǎn)換為槽參數(shù)。clicked 信號還有一個 bool checked 參數(shù)如果你使用QPushButton::clicked連接到無參 lambda編譯通常沒問題但如果你的 lambda 想接收 checked 狀態(tài)就要寫成[this](bool checked){ ... }。這些細(xì)節(jié)用舊版字符串形式的 SIGNAL/SLOT 宏可能到運(yùn)行期才暴露新語法則更早發(fā)現(xiàn)問題。lambda 是控件練習(xí)里最靈活的連接方式。不過 lambda 默認(rèn)不會延長 receiver 生命周期只負(fù)責(zé)執(zhí)行邏輯。常見錯誤是在 lambda 里捕獲了 this 或控件指針結(jié)果界面已經(jīng)銷毀線程回調(diào)卻還在跑。處理辦法是判斷生命周期或者讓發(fā)送者和接收者都掛在同一父對象上關(guān)閉窗口時整個對象樹被釋放。另一個小坑是 lambda 捕獲了局部 QWidget 指針但如果該控件沒有父對象它生命周期獨(dú)立于窗口窗口關(guān)閉后它仍存活Lambda 執(zhí)行時可能操作一個隱藏但不銷毀的控件邏輯可能出乎意料。帶重載的信號也是新手高頻報(bào)錯點(diǎn)。QComboBox 的 currentIndexChanged 有 int 和 QString 兩個重載QSpinBox 的 valueChanged 在 Qt 中也有 int 和 QString 兩種形式。直接用 QSpinBox::valueChanged 作為參數(shù)會得到“no matching member function for call to connect”之類的錯誤。解決方法是顯式指定類型connect(spin, QOverloadint::of(QSpinBox::valueChanged), this, [this](int value) { label-setText(QString::number(value)); });Qt 6 中還提供了 qOverload 模板本質(zhì)上也是在編譯期選擇正確的信號重載版本。學(xué)控件時遇到這種錯誤不要跳過它是在幫你理解 C 的函數(shù)指針類型和信號重載。信號槽還可以跨線程使用。第 02 章不要求你寫多線程但要記住一個邊界在工作線程里不能直接調(diào)用控件對象的 setText、show、hide 等方法因?yàn)?QWidget 只能在主線程操作。正確做法是把要傳出的數(shù)據(jù)封裝成信號發(fā)出來由主線程的槽函數(shù)更新 UI。如果未來在老項(xiàng)目里看到界面卡死、崩潰、偶發(fā)不刷新好多都和“線程里操作了控件”有關(guān)。這也是為什么基礎(chǔ)篇后面會有事件循環(huán)和線程章節(jié)它們和常用控件是配套的。8. 生命周期、父子對象與控件釋放寫控件代碼時“用指針 new 出來的控件到底由誰 delete”必須有一個統(tǒng)一答案。Qt 的父子對象機(jī)制約定給控件指定 parent父析構(gòu)時會遞歸 delete 所有 child但如果你先 setParent 到一個窗口后來又把該控件 reparent 到另一個窗口所有權(quán)也會跟著變化舊的父對象不再替它釋放?；貞浺幌鲁Ｒ姶a。下面的寫法把 label 作為 child 傳給 windowwindow 生命周期結(jié)束時 label 自動釋放QWidget *window new QWidget; QLabel *label new QLabel(我是子控件, window);這種寫法簡潔但如果不理解所有關(guān)系有人可能會在中途手動 delete label導(dǎo)致 window 析構(gòu)時發(fā)生二次釋放。另一個常見誤區(qū)是把控件加入布局后再手動 delete。layout-addWidget 不是轉(zhuǎn)移普通智能指針addWidget 在絕大多數(shù)情況下會把控件 reparent 到 layout 所在的 widget所以在布局容器銷毀后再手動 delete 子控件同樣會觸發(fā)重復(fù)釋放。內(nèi)存管理的穩(wěn)妥策略是所有 QWidget 對象盡量指定一個明確的 parent不必手工 delete。頂層窗口或需要延遲釋放的對象使用 QObject::deleteLater。如果某個控件確實(shí)需要獨(dú)立存在用 std::unique_ptr 或 QPointer 去管理時要格外小心。做練習(xí)時想要內(nèi)存不炸最簡單的規(guī)則是“從一個普通變量開始逐步 setParent 或 addWidget不要到處散落裸 new 后的孤兒控件”。生命周期還影響信號槽。如果 receiver 對象先于 sender 被銷毀Qt 的信號槽連接默認(rèn)會自動斷開不會立刻崩潰這也是 Qt 對象樹設(shè)計(jì)帶來的好處。但如果接收者是 lambda 捕獲的裸指針而該裸指針不是 QObjectQt 無法感知它什么時候失效。因此建議在 lambda 中盡量不捕獲已經(jīng)失控的控件裸指針或者在稍大邏輯里把捕獲范圍控制為 this、索引、值類型等回到主線程再用安全的 findChild 或成員指針操作。9. 配套源碼和筆記拿到手后怎么用第 02 章的配套源碼和詳細(xì)筆記是這門課比其他純視頻內(nèi)容更高效的部分但前提是你會用。一拿到源碼不要直接全部拽進(jìn)工程里編譯先按目錄結(jié)構(gòu)認(rèn)識文件名判斷每個示例對應(yīng)哪一講。Qt 工程目錄往往包含 .pro 或 CMakeLists.txt、main.cpp、widget 類文件有些示例還帶 .ui。先看看主函數(shù)里都創(chuàng)建了什么控件再進(jìn)入類實(shí)現(xiàn)里看構(gòu)造函數(shù)的 setup 過程。筆記的推薦用法是“轉(zhuǎn)譯”成自己的表格。每學(xué)一個控件手寫或維護(hù)一張卡片內(nèi)容包含控件類名、頭文件、典型構(gòu)造函數(shù)參數(shù)、常用 setter/getter、發(fā)射的核心信號、需要注意的重載或父類特性。不要讓筆記停留摘抄。例如 QListWidget 卡片上如果寫了“常用信號 currentRowChanged”你就要配套寫下“當(dāng)前行變化時我可以結(jié)合 QStackedWidget 切頁”這才是可遷移的知識。源碼和視頻的差集正是你的學(xué)習(xí)收獲。先寫跑不動再打開源碼查先看視頻演示再關(guān)掉視頻把代碼補(bǔ)全。如果源碼能直接編譯嘗試刻意改造把單選按鈕改成復(fù)選框把 QSpinBox 改成 QDoubleSpinBox把列表項(xiàng)點(diǎn)擊改成一鍵刪除。每處改動都可能引入新編譯錯誤這些錯誤比視頻里見過的正常執(zhí)行過程更值錢。改錯了不要立刻回滾先把報(bào)錯信息讀完整養(yǎng)成看“編譯器前幾行關(guān)鍵信息”和“構(gòu)建輸出尾部錯誤”的習(xí)慣。10. 常見問題與排查方法控件學(xué)習(xí)階段的報(bào)錯集中在幾類環(huán)境插件錯誤、編譯鏈接錯誤、運(yùn)行期界面不顯示、信號槽無響應(yīng)、中文亂碼。下面把最常碰到的現(xiàn)象和排查路徑整理成表問題現(xiàn)象可能原因排查方式解決方案啟動提示 could not find the Qt platform plugin windows系統(tǒng)找不到 Qt 的 platforms 插件看可執(zhí)行文件旁有沒有 platforms 目錄檢查 PATH 是否有 Qt bin開發(fā)環(huán)境檢查 Kit 是否正確發(fā)布目錄用 windeployqt 補(bǔ)齊插件Linux 下提示 qxcbconnection: failed to initialize xrandr 或 xcb 加載失敗Qt xcb 平臺插件或依賴庫缺失啟動帶環(huán)境變量 QT_DEBUG_PLUGINS1查看缺失庫安裝 xcb、xkbcommon、xrandr 依賴Qt6 常需要 libxcb-cursor0窗口沒有顯示程序運(yùn)行后很快退出忘記調(diào)用 showmain 中沒有執(zhí)行 app.exec在構(gòu)造函數(shù)或 main 里檢查 show所有頂層控件要 showmain 最后 return app.exec()點(diǎn)擊按鈕后槽函數(shù)不觸發(fā)connect 寫錯、sender/receiver 生命周期問題、信號被覆蓋在槽函數(shù)第一行加 qDebug檢查 connect 是否執(zhí)行使用新式 connect確認(rèn)發(fā)送者對象是實(shí)際點(diǎn)擊的按鈕控件中文顯示亂碼Qt 5 MSVC 下源文件編碼與編譯器讀取編碼不一致檢查源文件編碼Qt 6 默認(rèn) UTF-8Qt5 MSVC 加 /utf-8 或統(tǒng)一 UTF-8 with BOM編譯報(bào)錯 undefined reference to vtable類中有 Q_OBJECT 但 moc 未生成檢查是否啟用 AUTOMOC 或 .pro 里 HEADERS 已包含頭文件清理 build 目錄重建檢查 CMake AUTOMOC布局后控件大小不隨窗口變化沒設(shè) Layout 拉伸比例或 sizePolicy拖拽窗口觀察控件邊界設(shè)置 QSizePolicy、layout-setStretch檢查最小尺寸QSpinBox/QComboBox 信號用函數(shù)指針 connect 報(bào)類型不匹配信號有重載查看函數(shù)提示確定具體參數(shù)用 QOverload ::of 或 qOverload關(guān)閉窗口后后臺進(jìn)程不退出事件循環(huán)被其他頂層窗口或定時器占用觀察關(guān)閉行為確認(rèn)所有頂層窗口關(guān)閉、QApplication::quitOnLastWindowClosed 默認(rèn)行為在這些問題里“ could not find the Qt platform plugin ”雖然是環(huán)境不是控件但它恰恰會在你最想看到控件時出現(xiàn)。開發(fā)環(huán)境跑 Qt 工程Qt 庫和 plugin 的路徑由編譯器環(huán)境變量或安裝器寫入如果你手動把 debug 目錄里生成的 exe 拷到其他地方運(yùn)行exe 旁邊沒有 platforms 目錄Qt 就會報(bào)這個錯。解決方案不是到代碼里改而是把 Qt 對應(yīng)的插件目錄一并復(fù)制。Windows 下使用windeployqt最可靠它會復(fù)制 Qt 運(yùn)行庫、插件和編譯器運(yùn)行庫。Linux 下出現(xiàn) qxcb 相關(guān)報(bào)錯時執(zhí)行一下項(xiàng)目的二進(jìn)制往往能給出更具體的 xcb 庫缺失。Qt 安裝時自帶的平臺插件依賴系統(tǒng)圖形庫和系統(tǒng)自帶的 Qt 庫沖突也可能導(dǎo)致插件版本不一致。常用做法是設(shè)置QT_DEBUG_PLUGINS1輸出插件細(xì)節(jié)方便快速定位。和控件代碼關(guān)系不大但不解決它后面所有控件頁面都無法彈出。如果點(diǎn)擊按鈕沒有反應(yīng)先用最簡單的方法判斷在槽里加qDebug() triggered;。如果點(diǎn)擊時沒有任何輸出說明 connect 沒生效或者發(fā)送者不對如果輸出了但界面沒變問題在槽實(shí)現(xiàn)邏輯或控件引用到了別處。信號槽連不上的一種隱蔽原因是運(yùn)行時又給同一個控件執(zhí)行 setObjectName 或換了代理導(dǎo)致事件被重新路由。遇到這類問題不要反復(fù)改 connect而是確認(rèn)連接的是同一個控件實(shí)例。中文亂碼問題在使用 MinGW 編譯器時較少因?yàn)楹芏喹h(huán)境默認(rèn)按 UTF-8 處理使用 MSVC 編譯器時若源文件是 UTF-8 無 BOM 而 MSVC 默認(rèn)按 GBK 讀取字符串常量就會亂碼。最穩(wěn)妥的做法是Qt 5.15 MSVC 項(xiàng)目在 .pro 中增加msvc: QMAKE_CXXFLAGS /utf-8CMake 項(xiàng)目可以給 target 加上/utf-8編譯選項(xiàng)或統(tǒng)一把源文件存成帶 BOM 的 UTF-8。Qt 6 中情況改善很多但老代碼遷移時仍要關(guān)注。編譯報(bào)錯出現(xiàn) “undefined reference to vtable for” 時幾乎都和 Q_OBJECT、moc 有關(guān)。Qt 的元對象系統(tǒng)需要在預(yù)處理階段掃描類聲明里的 Q_OBJECT 并生成 moc 文件。qmake 工程要把含有 Q_OBJECT 的類頭文件加入 HEADERSCMake 要開啟 AUTOMOC 或使用 qt_add_executable 提供的自動 moc。如果代碼從舊文件夾拷貝過來沒重新構(gòu)建清理掉 build 目錄后重新 qmake/cmake 往往就能恢復(fù)。11. 學(xué)完控件后向?qū)崙?zhàn)項(xiàng)目延伸的路第 02 章結(jié)束不代表控件就此學(xué)完。真正會寫控件的標(biāo)志不是能寫出十幾個單獨(dú)窗口而是能把一組控件組合成一個可用工具。如果你是沖著“重學(xué) QT”的完整路線來的接下來可以試著做一個綜合小項(xiàng)目把前三章知識串起來。舉個例子很多熱詞里提到的“qt 串口編程”“qt 時域圖轉(zhuǎn)換為頻域圖使用 qcustomplot 顯示”都是典型控件應(yīng)用。做一個串口調(diào)試助手界面層至少要用到 QComboBox 枚舉可用串口、QTextEdit 顯示收發(fā)的日志、QLineEdit 輸入發(fā)送內(nèi)容、QPushButton 控制打開和發(fā)送、QTimer 做輪詢或超時控制。這些控件單獨(dú)拉出來很簡單但要配合 QSerialPort 的 readyRead 信號、QByteArray 數(shù)據(jù)轉(zhuǎn)換、打開失敗提示、接收緩沖區(qū)長度控制難度立刻就上來了。做一個信號頻譜顯示工具也一樣底層是 FFT 計(jì)算界面層用 QCustomPlot 或 QChart 畫曲線。要在界面上選擇信號源、設(shè)置采樣點(diǎn)數(shù)、點(diǎn)擊開始采集、動態(tài)刷新曲線你仍然要依賴 QComboBox、QSpinBox、QPushButton、QTimer、布局以及信號槽協(xié)作。第 02 章的 14 講如果沒消化后面加再漂亮的繪圖庫也會感覺界面架構(gòu)很亂。后續(xù)章節(jié)大概率會往更底層和更抽象的方向走。QPainter 自定義繪圖、QEvent 事件處理、Model/View 架構(gòu)、視圖委托、線程與事件循環(huán)都會反過來影響你現(xiàn)在寫控件的方式。學(xué)習(xí)建議是不要把章與章切得太開可以每學(xué)完一個新知識點(diǎn)就回到常用控件章節(jié)做一個小改造控件加一個自定義繪制按鈕列表換成 QTableView model日志顯示用多線程接收。這個循環(huán)越滾越大你對 Qt 的理解才會從“能運(yùn)行”變成“能設(shè)計(jì)”。第 02 章真正的收獲不只是看懂了幾個控件的屬性窗口而是建立了一套從對象創(chuàng)建、布局到信號關(guān)聯(lián)的穩(wěn)固定式。后面開會話框、主窗口、復(fù)雜業(yè)務(wù)界面時都可以沿用它。建議把視頻、源碼、筆記按“先動手再對照、對照后改造、改造后記錄”的節(jié)奏排進(jìn)學(xué)習(xí)計(jì)劃整章過完后做一個小工具收尾再進(jìn)第 03 章。那樣你會發(fā)現(xiàn)后面的內(nèi)容順很多。