Qt5范例开发技能树：C++桌面应用从环境到打包部署

简介：《Qt5范例开发大全（完整目录版）.pdf》面向C++开发者及Qt入门进阶读者，围绕从开发环境搭建到应用打包部署的完整流程，系统梳理Qt5框架的核心知识与实践路径。全书按十四章展开，覆盖窗体应用、控件与组件使用、文件操作、图形图像处理、多媒体、系统操作、注册表、数据库基础、网络开发、进程与线程、数据安全及部署发布等主题，既适合初学者按章建立知识框架，也便于有经验开发者查阅常见场景的实现思路。资源包共1个PDF文件，大小约2.84MB，完整目录版便于快速定位章节与范例条目；目前已有2459人学习或下载。书中以较丰富的实例和分章讲解呈现界面布局、控件组合、文件与数据库操作、网络及线程处理等要点，读者可对照练习并了解Qt应用打包发布的基本策略，逐步提升独立开发高效、美观Qt5应用程序的能力。

1. 从一份目录读出一套Qt5技能树：这份范例册子能解决什么

接手一个 C++ Qt5 老项目时，最怕的不是不会写 C++，而是不知道某个控件该调哪个属性、某个效果该用哪个类。手边这份《Qt5 范例开发大全》目录版正好补这个缺口：十四章从开发环境、窗体、控件一路排到数据库、网络、线程和打包部署，每个小节对应一个能独立编译的最小范例。它不适合当语法书从头读到尾，适合当查漏补缺的索引——手上有活，翻到对应章节找最小可运行例子，抄过来改参数。适合的读者很明确：会一点 C++、能看懂信号槽，但没系统写过 Qt 桌面程序的人；或者写过几年 MFC、刚转到 Qt 想快速对齐概念的人。目录本身就是一张技能树，先看目录定位，再决定翻哪页，效率比通读高得多。

2. 开发环境与工程骨架：Qt Creator 装好后第一个能跑的工程

2.1 环境准备：离线安装包与环境变量

书里给的组合是 Qt 5.1.1 + MinGW 4.8 + OpenGL 的 32 位离线安装包，一个 exe 六百多兆，双击一路下一步就完事。选离线包而不是在线安装器，是因为那个年代网络不稳，在线装到一半断掉，重来时组件状态经常对不上，清理起来很烦。现在装 Qt 5.15 LTS 也一样的思路，只是目录从Qt\Qt5.1.1\5.1.1\mingw48_32\bin变成Qt\5.15.2\mingw81_64\bin，原理没变。

装完必须配环境变量，这一步不做，后面发布 exe 时会踩坑：

# 把 Qt 的 bin 目录追加到系统 Path，注意前面保留分号 ;D:\Qt\Qt5.1.1\5.1.1\mingw48_32\bin

这个路径里放的是Qt5Core.dll、Qt5Gui.dll、Qt5Widgets.dll这些运行时库。配好之后，编译出来的 exe 双击就能起来，不用每次都进 Qt Creator 点运行。参数上唯一要注意的是别把多个 Qt 版本的 bin 同时塞进 Path 前面，否则编译用的是一套库、运行加载的是另一套，表现出来就是程序启动即崩、没有任何提示，排查起来很费时间。

提示：环境变量改完要重新打开命令行或重启 Qt Creator，已经开着的进程读不到新值。

2.2 工程骨架：.pro、main.cpp、mainwindow.cpp 各管什么

新建一个 Qt Gui 应用，Qt Creator 会自动生成四个文件，职责划分很清楚。.pro是 qmake 的工程描述，main.cpp是程序入口，mainwindow.cpp是窗体实现，.ui是界面描述文件。先看.pro：

QT += core gui # Qt5 把 widgets 从 gui 里拆出来了，这行必须显式加 greaterThan(QT_MAJOR_VERSION, 4): QT += widgets TARGET = QtOne # 生成的可执行文件名 TEMPLATE = app # 应用类型，app 表示可执行程序 SOURCES += main.cpp\ mainwindow.cpp HEADERS += mainwindow.h FORMS += mainwindow.ui

QT += widgets这行是 Qt4 转 Qt5 时最高频的编译错误来源。Qt4 里QApplication、QWidget都在 gui 模块下，Qt5 拆出去单独成了 widgets 模块，漏写就会报一堆 "undefined reference to QApplication::xxx"。看到这类链接错误，第一反应先翻.pro，比翻代码快。

main.cpp是入口，结构基本固定：

#include "mainwindow.h" #include <QApplication> int main(int argc, char *argv[]) { // argc 是命令行参数个数，argv 是参数字符串数组 QApplication a(argc, argv); MainWindow w; // 实例化主窗体 w.show(); // 显示窗体 return a.exec(); // 进入事件循环，程序阻塞在这里 }

a.exec()是 Qt 程序的核心，它启动事件循环，之后所有的鼠标点击、键盘输入、定时器、网络回调都靠这个循环分发。没有它，窗体闪一下就退出了。这一点跟控制台程序从main返回就结束完全不同，很多从 C 转过来的人第一次会疑惑"为什么show()之后程序不往下走"。

窗体里加一个标签显示文字，是书里第一个完整例子：

#include "mainwindow.h" #include "ui_mainwindow.h" #include <QLabel> MainWindow::MainWindow(QWidget *parent) : QMainWindow(parent), ui(new Ui::MainWindow) { ui->setupUi(this); // 加载 .ui 里拖的控件 QLabel *label = new QLabel(this); // this 指定父对象，自动管理内存 label->setText("Hello World"); // 设置显示内容 // QRect(x, y, width, height)：相对父窗体的左上角坐标和宽高 label->setGeometry(QRect(10, 10, 100, 30)); }

setGeometry的四个参数依次是 X 坐标、Y 坐标、控件宽度、控件高度，单位是像素，相对父窗体左上角计算。new QLabel(this)里的this是关键，指定了父对象之后，父窗体析构时会自动 delete 所有子控件，不需要手动写 delete，这是 Qt 对象树机制的一部分。刚接触时容易漏掉这个参数，结果就是控件显示不出来，或者退出时内存泄漏。

2.3 三种基类的选择：QMainWindow、QWidget、QDialog

创建工程时编辑器会让你选基类，这三个选项后面整套代码结构都不一样，选错了改起来要动头文件。

判断方法很简单：需要顶部菜单和底部状态栏的，选QMainWindow；只是一个独立的小窗口或者要嵌到别的容器里的自定义控件，选QWidget；需要用户点"确定/取消"并返回一个结果给调用方的，选QDialog。书里第二章的多窗体调用、登录窗口这两节，本质上就是在讲QDialog的模态和非模态区别——模态用exec()阻塞等待返回值，非模态用show()立即返回，两者混用会导致父窗体被意外阻塞。

3. 窗体与控件：把第二章第三章的零散范例拼成可复用的界面骨架

3.1 窗体属性控制：大小、位置、背景色与图标

第二章前几节全是窗体属性的单独演示，实际项目里这些代码通常集中在构造函数里一次性设完。控制窗体大小这块，书里用的是最大最小尺寸同时锁死：

// 标题栏文字 this->setWindowTitle("Qt5 窗体应用"); // 最大和最小都设成 300x300，等于禁止拖拽改变大小 this->setMaximumSize(300, 300); this->setMinimumSize(300, 300);

只设setFixedSize(300, 300)效果一样，内部就是把最大最小都设成同一个值。区别在于分开写之后，以后想放开某一方向（比如只锁宽度）改起来方便。

位置和背景色两行搞定：

// 默认居中显示，move 改成相对屏幕左上角的绝对坐标 this->move(100, 100); // 用样式表设背景，比调 QPalette 直观 this->setStyleSheet("background:red");

move(100, 100)的坐标系是屏幕左上角，不是父窗体。如果这个窗体有父窗口，坐标就变成相对父窗口客户区，这一点在嵌套窗口里经常搞混。setStyleSheet是 Qt 的样式表接口，语法接近 CSS，改背景、边框、圆角都靠它，比QPalette灵活，代价是复杂样式表会拖慢渲染，列表项特别多的控件上要谨慎。

标题栏图标要配资源文件。做法是在工程目录建个resource文件夹放 ICO 图片，然后新建 Qt 资源文件.qrc，添加前缀、添加文件，再给文件起个别名：

// :/new/prefix1/ico 是资源路径，ico 是添加文件时起的别名 // 不起别名的话，这里要写完整文件名包括后缀 this->setWindowIcon(QIcon(":/new/prefix1/ico"));

资源路径的规则是:/前缀/别名。资源文件的好处是图片被编译进 exe，发布时不用带一堆散图；坏处是改图必须重新编译，而且大图会显著撑大二进制体积。图标建议 16x16 或 32x32 的 ICO，尺寸太大在标题栏里显示会糊。

3.2 无边框窗体拖动：三个鼠标事件加坐标差

去掉标题栏之后窗体就没法拖了，书里这段代码是全书被抄得最多的范例之一，也是最容易抄出问题的一段。先看头文件要加什么：

#include <QMouseEvent> // 鼠标事件类 #include <QPushButton> // 关闭按钮 protected: void mousePressEvent(QMouseEvent *e); // 按下 void mouseMoveEvent(QMouseEvent *e); // 移动 void mouseReleaseEvent(QMouseEvent *e); // 释放 private: QPushButton *btClose; QPoint last; // 记录上一次的全局鼠标位置

三个事件里，按下时记录起点，移动时算位移并挪窗体，释放时收尾：

MainWindow::MainWindow(QWidget *parent) : QMainWindow(parent) { // 去掉系统标题栏和边框 this->setWindowFlags(Qt::FramelessWindowHint); // 没有标题栏就没有关闭按钮，自己补一个 btClose = new QPushButton(this); btClose->setText("关闭"); connect(btClose, SIGNAL(clicked()), this, SLOT(close())); } void MainWindow::mousePressEvent(QMouseEvent *e) { last = e->globalPos(); // 记录按下时的全局坐标 } void MainWindow::mouseMoveEvent(QMouseEvent *e) { int dx = e->globalX() - last.x(); // 本次移动的水平增量 int dy = e->globalY() - last.y(); last = e->globalPos(); // 更新基准点 move(x() + dx, y() + dy); // x()/y() 是窗体当前位置 } void MainWindow::mouseReleaseEvent(QMouseEvent *e) { // 这里不要再 move 一次，否则窗体在松开时会突跳一段 }

globalPos()返回的是相对屏幕的绝对坐标，x()/y()返回窗体相对父窗口的位置。用全局坐标算差值再叠加到窗体的局部位置上，这样无论窗体嵌在哪一层都能正常拖动。书里原文在mouseReleaseEvent里又算了一次dx/dy并调用了move，这是不严谨的：因为last在移动过程中已被更新，释放时算出的增量很小，但松手瞬间那一帧的事件顺序不保证，偶尔就会出现窗体突然往右下跳几十像素的现象。我当时照抄跑出来就是这个效果，一开始还以为是鼠标驱动的问题，后来把 release 里的move删掉就正常了。

提示：无边框窗体去掉的不只是外观，系统级的最小化、最大化、双击标题栏还原、边缘拖拽缩放全部失效，需要的话得自己实现。

3.3 控件选型速查：从 QPushButton 到 QTableView

第三章二十多个控件，实际项目里常用的就那么十来个，剩下的是特定场景才会碰。按输入、展示、容器三类分一下，选型时按需求对号入座比逐个看文档快。

QTextEdit和QPlainTextEdit的区别值得单独说：前者支持富文本、图片、HTML，后者只处理纯文本但针对大段日志做了性能优化。做日志窗口时用QTextEdit追加几万行会明显卡顿，换成QPlainTextEdit加setMaximumBlockCount(1000)限制最大行数，把老的自动裁掉，内存和速度都能稳住。

QRadioButton有一个典型坑：同一父控件下所有单选按钮默认互斥，如果窗口里有两组不相关的单选按钮，点第一组会影响第二组。解决办法是每组包一个QGroupBox，或者显式放进各自的QButtonGroup。

3.4 布局与菜单托盘：让界面不靠手摆坐标

手写setGeometry在控件少的时候还行，一旦控件超过五行，窗口一放大所有控件位置全乱，而且不同系统字体渲染宽度不一样，摆出来的界面在别人机器上就会挤在一起。书里第三章后半段的两节布局是必须掌握的部分：

// 横向布局：里面控件从左到右排，随窗口拉伸 QHBoxLayout *hLayout = new QHBoxLayout; hLayout->addWidget(new QLabel("用户名")); hLayout->addWidget(new QLineEdit); hLayout->addWidget(new QPushButton("登录")); // 网格布局：行号、列号从 0 开始 QGridLayout *grid = new QGridLayout; grid->addWidget(new QLabel("密码"), 0, 0); grid->addWidget(new QLineEdit, 0, 1); // 布局不能直接设置在 QMainWindow 上，要包一层 QWidget 当中央部件 QWidget *central = new QWidget(this); QVBoxLayout *vLayout = new QVBoxLayout(central); vLayout->addLayout(grid); vLayout->addLayout(hLayout); setCentralWidget(central);

QMainWindow自带中央部件概念，直接把布局setLayout上去是无效的，必须新建一个QWidget作为容器，把布局设到容器上，再把容器setCentralWidget。这个约束第一次碰到基本都要试错一遍。

任务栏托盘菜单是桌面程序很实用的一节，最小化到系统托盘比直接最小化体验好：

QSystemTrayIcon *tray = new QSystemTrayIcon(this); tray->setIcon(QIcon(":/new/prefix1/ico")); tray->setToolTip("程序运行中"); QMenu *trayMenu = new QMenu(this); trayMenu->addAction("显示主界面", this, SLOT(showNormal())); trayMenu->addAction("退出", qApp, SLOT(quit())); tray->setContextMenu(trayMenu); tray->show(); // 不调 show() 图标不会出现

tray->show()漏写是高频问题，表现出来就是托盘区什么都没有，代码看着全对。另一个是关闭窗口时的行为，默认点 X 会退出程序，要最小化到托盘得重写closeEvent，先hide()再ignore()掉关闭事件。

4. 文件、图形图像与多媒体：QFile、QPainter、QMediaPlayer 三条落地线

4.1 文件与配置：QFile 写文件、QSettings 读写 INI、QDomDocument 读写 XML

文件操作这块书里从创建文件夹讲到 XML，其实日常开发用得最多的是三件事：写日志、存配置、导数据。

创建目录写文件：

QDir dir; // mkpath 会递归创建，返回 false 表示已存在或没权限 if (!dir.mkpath("D:/data/logs")) { qDebug() << "目录创建失败"; } QFile file("D:/data/logs/app.txt"); // WriteOnly 覆写，Append 追加，Text 表示按文本模式处理换行 if (file.open(QIODevice::WriteOnly | QIODevice::Append | QIODevice::Text)) { QTextStream out(&file); out << QDateTime::currentDateTime().toString("yyyy-MM-dd hh:mm:ss") << " 启动" << endl; file.close(); // 不关文件，内容可能还在缓冲区没落盘 }

QIODevice::Append和WriteOnly的组合是追写日志的标准写法。QTextStream会自动处理编码，Qt5 默认是 UTF-8，读中文文件时如果源文件是 GBK，需要在流上setCodec("GBK")，否则全是乱码——这是 Windows 上处理老文本文件最常见的坑。

配置读写用QSettings，比自己解析 INI 省事：

// 第二个参数指定格式，IniFormat 才是 INI 文件 QSettings ini("D:/data/config.ini", QSettings::IniFormat); // 写入，key 用 / 分层，生成的文件里是 [user] 段 ini.setValue("user/name", "admin"); ini.setValue("user/level", 3); ini.sync(); // 立即落盘，不调的话要等析构 // 读取，第二个参数是默认值 QString name = ini.value("user/name", "guest").toString(); int level = ini.value("user/level", 1).toInt();

value()的第二个参数是默认值，配置项不存在时返回它，这样能省掉一层判断。不传默认值返回的是QVariant()，转toString()得空字符串，转toInt()得 0，逻辑上容易被当成合法值。

XML 读写用QDomDocument，适合配置文件有嵌套结构的场景：

QDomDocument doc; QDomElement root = doc.createElement("config"); doc.appendChild(root); QDomElement item = doc.createElement("item"); item.setAttribute("id", "1"); item.appendChild(doc.createTextNode("内容")); root.appendChild(item); QFile f("D:/data/a.xml"); if (f.open(QIODevice::WriteOnly | QIODevice::Text)) { QTextStream ts(&f); doc.save(ts, 4); // 4 是缩进空格数，只影响可读性 }

读取时用firstChild()配合nextSibling()遍历，注意每次都要判断isNull()，因为节点类型不匹配时（比如toElement()用在文本节点上）会返回空元素，继续往下取属性就崩了。

4.2 图形图像：QPainter 绘制与 QImage 的变换效果

第六章十四节里，绘制部分靠QPainter，图像处理部分靠QImage的成员函数和像素操作。绘制要写在paintEvent里：

void MainWindow::paintEvent(QPaintEvent *e) { QPainter p(this); // 绑定到当前窗口 p.setPen(QPen(Qt::blue, 2)); // 画笔颜色和线宽 p.drawLine(10, 10, 200, 10); // 起点终点坐标 p.drawEllipse(20, 30, 100, 60); // 左上角坐标 + 宽高 p.drawText(50, 110, "Qt5"); // 基线位置 }

paintEvent会被系统频繁调用（窗口遮挡、移动、缩放都会触发），里面不要做耗时的计算和文件读取，否则界面会卡。需要预处理的图像提前加载到成员变量里，绘制时直接贴。

图片缩放、翻转、加文字的常见写法：

QImage img(":/new/prefix1/pic.png"); // 按比例缩放到 200x200 以内，SmoothTransformation 是平滑插值 QImage small = img.scaled(200, 200, Qt::KeepAspectRatio, Qt::SmoothTransformation); // 水平翻转，第一个参数控制水平，第二个控制垂直 QImage flipped = img.mirrored(true, false); QPixmap pix = QPixmap::fromImage(small); label->setPixmap(pix);

Qt::KeepAspectRatio保证不变形，另一个选项IgnoreAspectRatio会拉伸，做缩略图列表时用前者。SmoothTransformation比默认的FastTransformation慢，但缩小时锯齿少很多，代价可以接受。

模糊、着色、阴影这几节，书里给的是基于像素遍历的实现，思路是把QImage转成Format_ARGB32，然后用pixel()/setPixel()逐点算。这种写法在教学上很清楚，但真用到几百张图上性能很差。实际项目里模糊效果我一般直接用QGraphicsBlurEffect挂到控件上，或者对单张图用QGraphicsScene渲染一遍：

QGraphicsBlurEffect *blur = new QGraphicsBlurEffect; blur->setBlurRadius(8); // 半径越大越糊，也越慢 label->setGraphicsEffect(blur);

setGraphicsEffect会接管控件的绘制流程，同一个控件只能挂一个效果，再挂第二个会把第一个顶掉。这个限制在同时要模糊和阴影的时候会卡住，办法是套一层容器控件，各挂各的。

4.3 多媒体：QMediaPlayer 播视频、QMovie 播动画

音视频播放要用 multimedia 模块，.pro里先加：

QT += multimedia multimediawidgets

播放本地视频的最小代码：

QMediaPlayer *player = new QMediaPlayer(this); QVideoWidget *video = new QVideoWidget(this); player->setVideoOutput(video); // 绑定显示窗口 player->setMedia(QUrl::fromLocalFile("D:/video/demo.mp4")); player->play(); connect(player, SIGNAL(stateChanged(QMediaPlayer::State)), this, SLOT(onStateChanged(QMediaPlayer::State)));

setMedia传的是QUrl，本地文件必须用QUrl::fromLocalFile()包一层，直接传字符串在 Windows 上因为盘符里的冒号会被解析成协议名而失败，表现为播放器无反应也不报错。这是我在一个项目里查了半天的问题。

QMovie播 GIF 之类的图片动画简单得多，不需要多媒体模块：

QMovie *movie = new QMovie(":/new/prefix1/loading.gif"); label->setMovie(movie); movie->start(); // 不调 start() 只显示第一帧

QMovie支持 GIF、MNG、APNG，不支持视频。判断加载是否成功用movie->isValid()，资源路径写错时不会抛异常，只会静默不显示。

4.4 系统操作：分辨率、IP、环境变量与外部命令

第八章几节都很短，但用得上。取屏幕尺寸：

QRect rect = QApplication::desktop()->screenGeometry(); qDebug() << rect.width() << rect.height();

多显示器时screenGeometry()不带参数返回主屏，要指定屏幕用screenGeometry(int screen)，屏幕数量靠desktop()->screenCount()。做全屏覆盖或者居中定位时，这两个值直接影响结果。

执行外部命令用QProcess：

QProcess p; p.start("cmd", QStringList() << "/c" << "ipconfig"); p.waitForFinished(3000); // 最多等 3 秒 QByteArray out = p.readAllStandardOutput();

waitForFinished会阻塞界面，只能用在后台线程或者启动阶段的短命令上。放在按钮点击里执行一个耗时命令，整个窗口会假死。正确做法是连readyReadStandardOutput和finished信号，异步收数据。

5. 数据库、网络、线程与数据安全：先讲通，再讲怎么排查

5.1 数据库：QSqlDatabase、QSqlQuery 与 QSqlTableModel

Qt 的数据库访问分三层：驱动层QSqlDatabase、SQL 语句层QSqlQuery、模型层QSqlTableModel/QSqlQueryModel。查驱动是第一步：

QStringList drivers = QSqlDatabase::drivers(); qDebug() << drivers; // 常见有 QSQLITE、QMYSQL、QODBC

列表里没有目标驱动，说明对应的插件 dll 没被找到，去 Qt 安装目录的plugins/sqldrivers下确认，或者把那个目录加到程序搜索路径。

SQLite 是最省事的，不用装服务端：

QSqlDatabase db = QSqlDatabase::addDatabase("QSQLITE"); db.setDatabaseName("D:/data/test.db"); if (!db.open()) { qDebug() << db.lastError().text(); // 失败一定要打这句 return; } QSqlQuery q(db); q.exec("CREATE TABLE IF NOT EXISTS user(id INTEGER PRIMARY KEY, name TEXT)"); // 带参数必须用 prepare + addBindValue，别拼字符串 q.prepare("INSERT INTO user(name) VALUES(?)"); q.addBindValue("张三"); if (!q.exec()) { qDebug() << q.lastError().text(); }

用?占位符而不是字符串拼接，一是防注入，二是避免中文和引号转义问题。lastError().text()是排查数据库问题的唯一入口，不打印它等于把黑匣子扔掉。

表格展示用QSqlTableModel，比手动填QTableWidget省事，改完调submitAll就落库：

QSqlTableModel *model = new QSqlTableModel(this, db); model->setTable("user"); // OnManualSubmit 表示改动先缓存，调 submitAll() 才写库 model->setEditStrategy(QSqlTableModel::OnManualSubmit); model->select(); ui->tableView->setModel(model);

setEditStrategy默认是OnFieldChange，光标离开单元格就写库，用户改错了没有撤销机会。做成编辑界面我一般用OnManualSubmit，配"保存/取消"两个按钮，体验更接近用户预期。

5.2 网络：TCP 点对点、UDP 广播和邮件发送

点对点聊天服务端的最小骨架：

QTcpServer *server = new QTcpServer(this); connect(server, SIGNAL(newConnection()), this, SLOT(onNewConnection())); if (!server->listen(QHostAddress::Any, 8888)) { qDebug() << server->errorString(); } void Server::onNewConnection() { QTcpSocket *socket = server->nextPendingConnection(); connect(socket, SIGNAL(readyRead()), this, SLOT(onReadyRead())); connect(socket, SIGNAL(disconnected()), socket, SLOT(deleteLater())); }

listen的QHostAddress::Any表示监听所有网卡，只监听本机改成QHostAddress::LocalHost。nextPendingConnection()每次只能取一个，多个客户端同时连上来时要循环取，漏取会导致连接堆积。

UDP 广播省掉连接管理，适合局域网发现：

QUdpSocket *udp = new QUdpSocket(this); // 广播地址 + 端口，数据量小的时候比 TCP 省事 udp->writeDatagram("DISCOVER", QHostAddress::Broadcast, 45454);

发邮件那一节用的是 SMTP 协议手写交互，连服务器、发 EHLO、AUTH LOGIN、MAIL FROM、RCPT TO、DATA。这部分代码长且容易出错，现在多半直接用现成的邮件库，或者干脆走服务端接口。手写 SMTP 的价值在于理解协议流程，生产环境不建议自己维护。

5.3 线程：QThread 与 QRunnable 两条路

Qt 里跑后台任务有两条路。继承QThread重写run()最直观：

class Worker : public QThread { Q_OBJECT protected: void run() override { for (int i = 0; i < 100; ++i) { if (isInterruptionRequested()) break; // 响应取消 emit progress(i); msleep(50); } } signals: void progress(int value); };

注意run()里跑的是新线程，而Worker对象本身还活在创建它的线程里，所以run()里碰 UI 会崩。要更新界面必须发信号，让槽函数在主线程执行，Qt 的队列连接会自动处理这个跨线程投递。

QRunnable配线程池更适合大量短任务：

class Task : public QRunnable { public: void run() override { // 耗时操作，不能碰 UI } }; // 默认线程数是 CPU 核心数，可以调 QThreadPool::globalInstance()->setMaxThreadCount(4); QThreadPool::globalInstance()->start(new Task);

QRunnable默认任务结束自动 delete，不想自动管理就setAutoDelete(false)。线程池的好处是任务多了不会无限开线程，坏处是不能单独控制某个任务的优先级。

5.4 数据安全：哈希、对称加密与随机数

MD5 用QCryptographicHash一行搞定：

QByteArray md5 = QCryptographicHash::hash("secret", QCryptographicHash::Md5).toHex();

要分块算大文件就addData()多次再result()。MD5 现在只能用来做完整性校验，不能用于密码存储，密码应该用带盐的慢哈希算法。

AES 这块 Qt 没有内置接口，书里的做法是自己封装一套加解密类，或者引入轻量实现挂到工程里。不管用哪种，密钥和 IV 都不能硬编码在源码里，也别用 ECB 模式——同样的明文块会算出同样的密文块，图像加密时尤其明显，一眼能看出轮廓。

随机数生成在 Qt 5.10 之后推荐QRandomGenerator：

int n = QRandomGenerator::global()->bounded(100); // 0 到 99

老版本的qsrand()+qrand()组合如果没有先qsrand播种，每次启动生成的序列完全一样，做抽奖或者验证码会被人一眼看穿。

5.5 五条高频翻车现场：现象、原因、解决

现象：程序双击启动后一闪就退，命令行运行提示找不到 Qt5Core.dll。原因：用 Qt Creator 里点运行能起，是因为 IDE 帮你注入了库路径；直接双击 exe 走的是系统 Path，环境变量没配或者配错版本。 解决：确认 Path 里的bin目录和编译用的 Qt 版本一致，或者用windeployqt把依赖 dll 拷到 exe 同目录。

现象：中文显示成方块或者乱码。原因：源文件编码和编译器识别的编码不一致，或者读取外部文本文件时没指定编码。 解决：源文件统一存成 UTF-8，Qt5 里给QTextStream显式setCodec("UTF-8")，读 GBK 文件时改成setCodec("GBK")。

现象：子线程里更新界面，程序随机崩溃。原因：Qt 的界面对象只能在主线程操作，跨线程直接调setText之类的会破坏内部状态。 解决：改成信号槽通信，连接类型用默认的Qt::AutoConnection，跨线程会自动排到主线程执行。

现象：.pro里加了QT += network但链接时报 undefined reference。原因：改完.pro没有重新执行 qmake，编译用的 Makefile 还是旧的。 解决：Qt Creator 里执行"构建 → 执行 qmake"，或者删掉构建目录重新构建。

现象：数据库在开发机能用，拷到客户机器上打开失败。原因：SQLite 的数据库路径写成了开发机的绝对路径，或者驱动插件没随程序发布。 解决：路径改成基于QCoreApplication::applicationDirPath()拼接，发布时把sqldrivers目录一起带上。

6. 打包部署与二次开发：从能跑到能交付的最后一公里

6.1 两条打包路线：依赖收集与安装包制作

第十四章讲的两件事经常被混为一谈：FilePacker 解决的是"把 exe 和一堆 dll 合成一个文件"，Inno Setup 解决的是"做一个带向导的安装程序"。前者是单文件绿色版，后者是标准安装流程，按交付对象选。

不管走哪条，第一步都是把依赖收齐。手动一个个找 dll 太容易漏，用 Qt 自带的工具：

# 把 exe 拷到一个空目录，然后在该目录执行 windeployqt.exe MyApp.exe # 会自动拷入 Qt5Core.dll、platforms/qwindows.dll 等 # 加了 --no-translations 可以省掉一堆语言包 windeployqt.exe --release --no-translations MyApp.exe

platforms/qwindows.dll是最容易漏的一个。缺了它，程序启动直接报 "This application failed to start because no Qt platform plugin could be initialized"，而且这个提示框在没装 Qt 的机器上才会出现，开发机上永远复现不了。打包完一定要找一台干净机器或者虚拟机跑一遍。

6.2 二次开发改造思路：把范例变成自己的模块

书里的范例都是单文件、单功能的最小实现，直接往项目里搬会因为命名冲突、全局变量、写死路径出问题。我的做法是先按职责分目录，再逐个搬：

搬的过程中有三件事必做。第一，把所有硬编码的D:/data/xxx换成一个统一的路径函数，基于applicationDirPath()拼；第二，把qDebug()换成自己的日志宏，发布版要能关掉输出又能落文件；第三，信号槽连接集中到一个initConnections()里，别散落在各个函数中间，后面查"这个按钮到底连了谁"会感谢自己。

改造完一个模块，验证方法是写一个最小的调用方，只依赖这个模块，编译通过并且功能正常，再往主工程里合。直接把十几个范例一次性全搬进去，出了问题根本定位不到是哪一块。

还有一个实用技巧：书里很多效果是用像素遍历实现的，比如模糊、着色、阴影。这些代码在书上看着没问题，实际跑几百张图会卡到不能用。改造时先做性能测试，用QElapsedTimer量一下单张耗时，超过 50 毫秒的就想办法换实现或者放到线程池里跑，别等到用户抱怨界面卡死再回头改。

6.3 验证清单：从编译过到换机器能跑

交付前我固定走三步。第一步本地Release编译零警告，警告里藏着类型转换和未初始化变量，发布版出问题最难查；第二步在干净虚拟机上跑一遍完整流程，重点看文件读写、数据库连接、网络监听这三类依赖环境的操作；第三步把安装包装上再卸一遍，确认注册表项、开始菜单快捷方式、配置文件目录都清理干净。

从那以后我每次打包前都强制走一遍windeployqt加干净机器验证，宁可多花二十分钟，也不想在客户现场打开电脑发现少了qwindows.dll。这份范例册子的价值不在读完，在于遇到具体问题时知道翻哪一页，把它放进项目文档目录，比放进收藏夹有用得多。希望帮到你。

本文还有配套的精品资源，点击获取