简介《C Qt5 范例开发大全》中文版面向希望系统掌握 Qt5 框架的 C 开发者从入门到进阶均可使用。内容以实例驱动覆盖开发环境搭建与 Hello World 起步、窗体基类与窗口大小、位置、背景色、标题栏图标、无边框移动、多窗体调用等窗口管理技巧以及 QPushButton、QLabel、QLineEdit、QTextEdit、QComboBox、QSpinBox、QTimeEdit、QDateEdit、QRadioButton、QCheckBox、QListView、QTreeView、QTableView 等常用控件和 QHBoxLayout、QGridLayout 布局管理并延伸至 QPainter 图形绘制与 QSslSocket、QCryptographicHash 加解密应用。资源包共 1 个 PDF 文件大小 2.83MB单文件即含完整章节与示例目录便于按章检索、对照实践。已有 257 人学习适合需要借范例快速上手 Qt5 界面开发与功能实现的读者查漏补缺。1. 拿到一份 Qt5 范例源码包先别急着编译上周有个做工业上位机的朋友发来一个压缩包说客户现场要加个托盘菜单和串口配置页他翻遍手头资料没找到能直接跑的 Qt5 例子问我这份《C Qt5 范例开发大全》值不值得拆。我打开目录扫了一眼——从 Hello World、窗体基类、二十多个常用控件到文件读写、QPainter 绘图、音视频播放、注册表、SQLite、TCP 点对点聊天、QThread再到 AES/MD5 和 Inno Setup 打包十四章基本把桌面端 Qt5 开发会碰到的场景铺了一遍。这类“范例大全”型资源的价值不在理论深度而在于每个技术点都有一个能独立编译的最小工程你缺哪块就拆哪块。适合两类人刚接触 Qt5、需要照着跑通第一个窗口的新手以及手头有具体功能要补、想找现成骨架改的老手。下面按我实际拆包的顺序讲重点放在怎么把范例变成自己项目里的代码以及哪些地方会翻车。2. 环境与工程骨架把范例跑起来的第一步2.1 版本对齐比装什么 IDE 更重要这份资料针对的是 Qt 5.1.1 MinGW 4.8 的 Windows 32 位离线包目录里所有 .pro 文件都是那个年代的写法。你现在装 Qt 大概率是 5.12、5.15 甚至 6.x直接双击打开 .pro 很可能报一堆模块找不到。我的做法是先确认三件事编译器套件MinGW 还是 MSVC、Qt 大版本、以及范例里用到的模块是否还在默认安装里。Qt5 的 core、gui、widgets、network、sql、multimedia 在 5.15 的在线安装器里要手动勾选尤其 multimedia 和 sql 的驱动插件漏勾了编译能过、运行时报“driver not loaded”这是血泪经验。判断一个范例能不能直接用的最快方式是看它的 .pro 里 QT 后面跟了什么。比如网络那一章的工程会写QT core gui network数据库那章会写QT sql。如果只写QT core gui那基本是纯界面例子跨版本迁移成本最低。2.2 用 qmake 命令行先验证再进 IDE我一般不进 Qt Creator先在命令行把工程跑一遍这样报错信息最干净不会被 IDE 的构建套件配置干扰。以第二章控制窗体大小的例子为例进入工程目录后# 进入范例工程目录先清理可能残留的构建产物 cd QtTwo/Qt01 # 用当前环境的 qmake 重新生成 Makefile注意 qmake 要在 PATH 里 qmake Qt01.pro # MinGW 套件用 mingw32-makeMSVC 套件换成 nmake mingw32-make -j4 # 运行生成的 exeWindows 下在 release 或 debug 子目录 ./release/Qt01.exe这段命令的逻辑是qmake 读取 .pro 生成平台相关的 Makefilemake 按依赖编译链接。参数上-j4是并行编译核数老机器上给 2 就行给太高反而因为内存不够链接失败。如果 qmake 报 “Unknown module(s) in QT: xxx”说明当前 Qt 安装没装那个模块回安装器补如果 make 报找不到头文件多半是 .pro 里的 INCLUDEPATH 写死了旧路径把绝对路径改成相对路径或删掉即可。2.3 三个基类怎么选决定了后面改代码的手感资料里专门讲了 QMainWindow、QWidget、QDialog 的区别这点值得展开因为选错基类后面加菜单栏、工具栏会非常别扭。QMainWindow 自带菜单条、工具条、状态栏和中央部件区适合做主窗口QWidget 是所有界面对象的基类最轻适合做嵌入面板或自定义控件QDialog 是对话框基类支持模态和非模态、有默认按钮和返回值适合登录框、设置页这类短期交互。我踩过的坑是拿 QWidget 做主窗口后来要加菜单栏只能手动塞 QMenuBar 再自己管布局代码越写越乱。判断标准很简单这个窗口有没有菜单、工具条、状态栏中的任意一个有就用 QMainWindow是不是弹出来让用户填完就关是就用 QDialog剩下的一律 QWidget。范例里登录窗口用的是 QDialog主界面用的是 QMainWindow照着这个对应关系改迁移成本最低。3. 控件与布局把范例里的散件拼成可用界面3.1 控件范例的正确拆法看信号槽而不是看外观第三章列了二十多个控件从 QPushButton 到 QTableView如果一个个照着敲效率很低。我的做法是只挑自己项目里要用的那三五个重点看范例里信号是怎么连到槽的。Qt5 推荐的新式语法是函数指针形式比老式 SIGNAL/SLOT 宏安全编译期就能检查参数类型。以按钮点击为例// 新式连接编译期检查参数不匹配直接报错 connect(ui-btnSave, QPushButton::clicked, this, MainWindow::onSaveClicked); // 老式写法运行期才报错字符串拼错很难查范例里可能混用 // connect(ui-btnSave, SIGNAL(clicked()), this, SLOT(onSaveClicked()));逻辑说明connect 的四个参数分别是发送者、信号、接收者、槽。新式写法用取地址符拿成员函数指针信号和槽的参数个数、类型必须兼容否则编译不过这比运行时报 “No such slot” 好查太多。参数上要注意如果槽函数带默认参数新式连接不会自动用默认值必须显式匹配。范例里如果还是老式宏迁移时顺手改成新式能省掉后面一堆玄学问题。3.2 布局管理别用绝对坐标用 QHBoxLayout 和 QGridLayout资料里 1.17 和 1.18 讲了横向布局和网格布局这是界面能不能自适应的关键。很多新手范例看多了会习惯用 setGeometry 写死坐标窗口一拉伸控件就错位。正确做法是把控件放进布局管理器让布局去算位置。一个典型的“标签 输入框 按钮”行// 创建横向布局把标签、输入框、按钮依次加入 QHBoxLayout *rowLayout new QHBoxLayout; rowLayout-addWidget(new QLabel(配置路径:)); rowLayout-addWidget(new QLineEdit, 1); // 第二个参数 1 是拉伸因子输入框占满剩余空间 rowLayout-addWidget(new QPushButton(浏览)); // 多行之间用垂直布局串起来最后设给中央部件 QVBoxLayout *mainLayout new QVBoxLayout; mainLayout-addLayout(rowLayout); mainLayout-addStretch(); // 底部加弹簧把内容顶上去 ui-centralWidget-setLayout(mainLayout);参数说明addWidget 的第二个参数是 stretch默认 0给 1 表示该控件在剩余空间里按比例分配addStretch 插入一个可伸缩空白用来把上面的内容压到顶部。网格布局 QGridLayout 用 addWidget(widget, row, column, rowSpan, columnSpan) 定位适合表单类界面。注意布局一旦设给某个父部件就不要再用 setGeometry 去动子控件两者会打架表现为控件位置跳来跳去。3.3 托盘菜单与多窗体调用两个高频需求的落地第三章 1.22 的任务栏托盘菜单和第二章 1.7 的多窗体调用是实际项目里问得最多的两个点。托盘菜单的核心是 QSystemTrayIcon需要先判断系统是否支持再挂菜单和激活信号// 构造托盘图标父对象设 this 让 Qt 管生命周期 trayIcon new QSystemTrayIcon(this); trayIcon-setIcon(QIcon(:/res/app.ico)); trayIcon-setToolTip(后台服务运行中); // 挂右键菜单 QMenu *trayMenu new QMenu(this); trayMenu-addAction(显示主窗口, this, MainWindow::showNormal); trayMenu-addAction(退出, qApp, QApplication::quit); trayIcon-setContextMenu(trayMenu); // 单击托盘图标恢复窗口双击同理 connect(trayIcon, QSystemTrayIcon::activated, this, [this](QSystemTrayIcon::ActivationReason reason){ if (reason QSystemTrayIcon::Trigger) showNormal(); }); trayIcon-show();逻辑上activated 信号带一个枚举参数说明触发方式单击、双击、中键等用 lambda 接住再判断比给每种方式单独连槽清爽。多窗体调用则要注意用 new 出来的子窗口如果 parent 设为 this关闭时只是隐藏不销毁反复打开会越积越多不想保留就设setAttribute(Qt::WA_DeleteOnClose)或者用栈对象 show 后 exec。范例里两种写法可能都有改的时候按“这个窗口要不要复用”来定。4. 文件、绘图与数据库范例里最容易踩坑的三块4.1 文件与 INI/XML路径和编码是两个隐形雷第五章的文件操作和 INI/XML 读写代码本身不长坑集中在路径和编码。QFile 用相对路径时基准是进程当前工作目录不是 exe 所在目录IDE 里跑和双击 exe 跑结果可能不一样。稳妥做法是用 QCoreApplication::applicationDirPath() 拼绝对路径。INI 读写用 QSettings注意第二个参数要显式给 QSettings::IniFormat否则 Windows 下默认写注册表// 显式指定 IniFormat路径用应用目录拼避免工作目录不一致 QString iniPath QCoreApplication::applicationDirPath() /config.ini; QSettings settings(iniPath, QSettings::IniFormat); settings.setIniCodec(UTF-8); // Qt5 下中文必须设编码否则乱码 settings.setValue(network/port, 8080); settings.sync(); // 立即落盘别等析构 int port settings.value(network/port, 8080).toInt();参数说明setIniCodec 在 Qt5 里有效Qt6 已移除该接口、默认 UTF-8sync() 强制写盘程序异常退出时没 sync 的数据会丢。XML 那两节用 QDomDocument读的时候注意 elementsByTagName 返回的是所有同名节点要按层级逐层找别指望一次拿到深层节点。4.2 QPainter 绘图抗锯齿和坐标变换的顺序第六章图形图像操作是这份资料里比较有含金量的一块绘制文字、线条、椭圆、图片缩放翻转、模糊着色阴影都覆盖了。QPainter 的关键是理解坐标系和状态栈。缩放、旋转、平移都会改变后续绘制的坐标系画完要 save/restore 配对否则影响后面的绘制void Widget::paintEvent(QPaintEvent *) { QPainter p(this); p.setRenderHint(QPainter::Antialiasing, true); // 抗锯齿线条才不毛糙 p.save(); // 保存当前坐标系状态 p.translate(100, 100); // 原点移到 (100,100) p.rotate(45); // 绕新原点旋转 45 度 p.drawRect(-50, -50, 100, 100); // 画一个居中的方块 p.restore(); // 恢复后续绘制不受影响 p.drawText(20, 20, 正常坐标系下的文字); }逻辑说明save/restore 是栈操作必须成对漏了 restore 会让后面的绘制全部带着旋转平移表现为“越画越偏”。抗锯齿对线条和文字效果明显但对大图片缩放会拖性能按需开。图片缩放用 scaled() 返回新 QPixmap注意保持宽高比否则图片变形模糊、着色、阴影这些效果在 Qt5 里可以用 QGraphicsBlurEffect 等效果类也可以自己用 QImage 逐像素处理范例里两种思路可能都有性能敏感的场景优先用效果类。4.3 SQLite 与 QThread连接不能跨线程这是硬约束第十章数据库和第十二章进程线程单独看都不难合在一起就是经典翻车现场在主线程建了 QSqlDatabase 连接丢到 QThread 里查询报 “QSqlDatabasePrivate::database: requested database does not belong to the calling thread”。Qt 的数据库连接是线程绑定的每个线程要自己建连接连接名还得不同// 在工作线程的 run() 或槽里创建本线程专属连接 void Worker::doQuery() { // 连接名带上线程 id保证唯一 QString connName QString(worker_%1) .arg(reinterpret_castquintptr(QThread::currentThreadId())); QSqlDatabase db QSqlDatabase::addDatabase(QSQLITE, connName); db.setDatabaseName(data.db); if (!db.open()) { /* 记录错误并返回 */ } QSqlQuery q(db); q.exec(SELECT * FROM records); // 用完关闭并从连接池移除否则连接名会越积越多 db.close(); QSqlDatabase::removeDatabase(connName); }参数说明addDatabase 的第二个参数是连接名不传就用默认连接多线程下必然冲突removeDatabase 要在所有 QSqlQuery 析构之后调用否则会警告“connection is still in use”。QThread 的用法上范例里 1.2 是继承 QThread 重写 run1.3 是 QRunnable 配合线程池前者适合长驻任务后者适合短任务批量跑。我一般优先用 moveToThread 的 worker 对象模式信号槽跨线程自动排队比继承 QThread 少踩坑。5. 避坑排查拆这份范例时最常翻的五个车5.1 编译过了运行报 “driver not loaded”现象数据库范例编译链接都正常一运行 open() 返回 false控制台提示 QSqlDatabase: QSQLITE driver not loaded。原因Qt 的 SQL 驱动是插件形式exe 目录下缺 sqldrivers 文件夹或者安装时没勾对应驱动。解决从 Qt 安装目录的 plugins/sqldrivers 把 qsqlite.dll 拷到 exe 同级 sqldrivers 目录用 windeployqt 工具会自动带再不行用QSqlDatabase::drivers()打印当前可用驱动确认。5.2 中文乱码界面和文件两头都乱现象源码里写的中文在界面显示成问号或者写进 INI/文本文件打开是乱码。原因Qt5 默认按 UTF-8 处理源码但 MSVC 编译器对无 BOM 的 UTF-8 源文件可能按本地编码解析文件读写没设编码。解决源文件统一存 UTF-8 带 BOMMSVC 下最稳或在 .pro 加QMAKE_CXXFLAGS /utf-8QTextStream 读写显式 setCodec(“UTF-8”)QSettings 设 setIniCodec。5.3 无边框窗体拖不动或拖动时窗口跳变现象照第二章 1.5 做了无边框窗体鼠标拖动时窗口位置乱跳或者只能拖一下。原因mouseMoveEvent 里用的是全局坐标减窗口左上角但没记录按下时的偏移量或者没判断左键是否按下。解决在 mousePressEvent 里存dragPos e-globalPos() - frameGeometry().topLeft()move 事件里判断e-buttons() Qt::LeftButton再move(e-globalPos() - dragPos)释放时清状态。5.4 打包后 exe 在别人机器上缺 DLL现象本机跑得好好的拷到客户机器双击报缺少 Qt5Core.dll 或平台插件 windows 找不到。原因只拷了 exe没带 Qt 运行库和 platforms 插件。解决用 Qt 自带的 windeployqt 对 exe 跑一遍自动收集依赖第十四章的 FilePacker 和 Inno Setup 是在此基础上做安装包顺序不能反——先 windeployqt 补齐依赖再打包否则装完照样起不来。5.5 定时器更新界面卡顿或时间不准现象第四章 1.6 用 QTimer 实时更新时间跑久了界面卡或者秒数跳变不均匀。原因定时器精度受事件循环负载影响interval 设太小比如 10ms又做重活事件队列堆积。解决刷新界面用 1000ms 足够重活丢到工作线程需要高精度计时用 QElapsedTimer 算差值而不是累加定时器次数。6. 从范例到项目我的二次封装习惯拆完这份资料真正让它产生价值的不是把例子跑一遍而是把重复出现的模式抽成自己的小工具。我一般会做三件事。第一建一个 base 目录把无边框窗体拖动、托盘图标初始化、INI 配置读写这三段封装成基类和工具函数后面每个新工程直接拷过去省掉每次重写。第二给每个范例工程加一个 README 记录“这个例子在 Qt 5.15 下改了什么”比如老式 connect 换成新式、QDesktopWidget 换成 QScreen下次再拆同类资源时直接对照。第三用一张表管理范例与需求的映射避免在二十多个控件例子里迷路需求场景对应范例章节迁移注意点主窗口带菜单工具栏第2章 窗体基类选 QMainWindow别用 QWidget登录/设置弹窗第4章 登录窗口QDialog exec注意返回值配置持久化第5章 INI 读写显式 IniFormat UTF-8后台任务不卡界面第12章 QThread数据库连接按线程建发布给客户第14章 打包先 windeployqt 再 Inno Setup验证一个范例是否真的吃透我的标准是把它改成一个自己项目里的小功能能编译、能跑、异常路径也走过一遍。比如把点对点聊天那两节改成局域网内一对多的消息广播中间会逼你处理粘包、连接断开重连、线程安全发消息这些是光看范例看不出来的。从那以后我每次拆这类范例包都强制自己先跑通命令行构建、再改一个真实小需求、最后用 windeployqt 打一次包三步走完才算这份资源真正落地。希望帮到你。本文还有配套的精品资源点击获取 
长河君 · 2026/11/3 6:10:24 · 阅读 1.2k Qt5范例开发大全实战拆解：从编译到项目迁移的避坑指南
简介《C Qt5 范例开发大全》中文版面向希望系统掌握 Qt5 框架的 C 开发者从入门到进阶均可使用。内容以实例驱动覆盖开发环境搭建与 Hello World 起步、窗体基类与窗口大小、位置、背景色、标题栏图标、无边框移动、多窗体调用等窗口管理技巧以及 QPushButton、QLabel、QLineEdit、QTextEdit、QComboBox、QSpinBox、QTimeEdit、QDateEdit、QRadioButton、QCheckBox、QListView、QTreeView、QTableView 等常用控件和 QHBoxLayout、QGridLayout 布局管理并延伸至 QPainter 图形绘制与 QSslSocket、QCryptographicHash 加解密应用。资源包共 1 个 PDF 文件大小 2.83MB单文件即含完整章节与示例目录便于按章检索、对照实践。已有 257 人学习适合需要借范例快速上手 Qt5 界面开发与功能实现的读者查漏补缺。1. 拿到一份 Qt5 范例源码包先别急着编译上周有个做工业上位机的朋友发来一个压缩包说客户现场要加个托盘菜单和串口配置页他翻遍手头资料没找到能直接跑的 Qt5 例子问我这份《C Qt5 范例开发大全》值不值得拆。我打开目录扫了一眼——从 Hello World、窗体基类、二十多个常用控件到文件读写、QPainter 绘图、音视频播放、注册表、SQLite、TCP 点对点聊天、QThread再到 AES/MD5 和 Inno Setup 打包十四章基本把桌面端 Qt5 开发会碰到的场景铺了一遍。这类“范例大全”型资源的价值不在理论深度而在于每个技术点都有一个能独立编译的最小工程你缺哪块就拆哪块。适合两类人刚接触 Qt5、需要照着跑通第一个窗口的新手以及手头有具体功能要补、想找现成骨架改的老手。下面按我实际拆包的顺序讲重点放在怎么把范例变成自己项目里的代码以及哪些地方会翻车。2. 环境与工程骨架把范例跑起来的第一步2.1 版本对齐比装什么 IDE 更重要这份资料针对的是 Qt 5.1.1 MinGW 4.8 的 Windows 32 位离线包目录里所有 .pro 文件都是那个年代的写法。你现在装 Qt 大概率是 5.12、5.15 甚至 6.x直接双击打开 .pro 很可能报一堆模块找不到。我的做法是先确认三件事编译器套件MinGW 还是 MSVC、Qt 大版本、以及范例里用到的模块是否还在默认安装里。Qt5 的 core、gui、widgets、network、sql、multimedia 在 5.15 的在线安装器里要手动勾选尤其 multimedia 和 sql 的驱动插件漏勾了编译能过、运行时报“driver not loaded”这是血泪经验。判断一个范例能不能直接用的最快方式是看它的 .pro 里 QT 后面跟了什么。比如网络那一章的工程会写QT core gui network数据库那章会写QT sql。如果只写QT core gui那基本是纯界面例子跨版本迁移成本最低。2.2 用 qmake 命令行先验证再进 IDE我一般不进 Qt Creator先在命令行把工程跑一遍这样报错信息最干净不会被 IDE 的构建套件配置干扰。以第二章控制窗体大小的例子为例进入工程目录后# 进入范例工程目录先清理可能残留的构建产物 cd QtTwo/Qt01 # 用当前环境的 qmake 重新生成 Makefile注意 qmake 要在 PATH 里 qmake Qt01.pro # MinGW 套件用 mingw32-makeMSVC 套件换成 nmake mingw32-make -j4 # 运行生成的 exeWindows 下在 release 或 debug 子目录 ./release/Qt01.exe这段命令的逻辑是qmake 读取 .pro 生成平台相关的 Makefilemake 按依赖编译链接。参数上-j4是并行编译核数老机器上给 2 就行给太高反而因为内存不够链接失败。如果 qmake 报 “Unknown module(s) in QT: xxx”说明当前 Qt 安装没装那个模块回安装器补如果 make 报找不到头文件多半是 .pro 里的 INCLUDEPATH 写死了旧路径把绝对路径改成相对路径或删掉即可。2.3 三个基类怎么选决定了后面改代码的手感资料里专门讲了 QMainWindow、QWidget、QDialog 的区别这点值得展开因为选错基类后面加菜单栏、工具栏会非常别扭。QMainWindow 自带菜单条、工具条、状态栏和中央部件区适合做主窗口QWidget 是所有界面对象的基类最轻适合做嵌入面板或自定义控件QDialog 是对话框基类支持模态和非模态、有默认按钮和返回值适合登录框、设置页这类短期交互。我踩过的坑是拿 QWidget 做主窗口后来要加菜单栏只能手动塞 QMenuBar 再自己管布局代码越写越乱。判断标准很简单这个窗口有没有菜单、工具条、状态栏中的任意一个有就用 QMainWindow是不是弹出来让用户填完就关是就用 QDialog剩下的一律 QWidget。范例里登录窗口用的是 QDialog主界面用的是 QMainWindow照着这个对应关系改迁移成本最低。3. 控件与布局把范例里的散件拼成可用界面3.1 控件范例的正确拆法看信号槽而不是看外观第三章列了二十多个控件从 QPushButton 到 QTableView如果一个个照着敲效率很低。我的做法是只挑自己项目里要用的那三五个重点看范例里信号是怎么连到槽的。Qt5 推荐的新式语法是函数指针形式比老式 SIGNAL/SLOT 宏安全编译期就能检查参数类型。以按钮点击为例// 新式连接编译期检查参数不匹配直接报错 connect(ui-btnSave, QPushButton::clicked, this, MainWindow::onSaveClicked); // 老式写法运行期才报错字符串拼错很难查范例里可能混用 // connect(ui-btnSave, SIGNAL(clicked()), this, SLOT(onSaveClicked()));逻辑说明connect 的四个参数分别是发送者、信号、接收者、槽。新式写法用取地址符拿成员函数指针信号和槽的参数个数、类型必须兼容否则编译不过这比运行时报 “No such slot” 好查太多。参数上要注意如果槽函数带默认参数新式连接不会自动用默认值必须显式匹配。范例里如果还是老式宏迁移时顺手改成新式能省掉后面一堆玄学问题。3.2 布局管理别用绝对坐标用 QHBoxLayout 和 QGridLayout资料里 1.17 和 1.18 讲了横向布局和网格布局这是界面能不能自适应的关键。很多新手范例看多了会习惯用 setGeometry 写死坐标窗口一拉伸控件就错位。正确做法是把控件放进布局管理器让布局去算位置。一个典型的“标签 输入框 按钮”行// 创建横向布局把标签、输入框、按钮依次加入 QHBoxLayout *rowLayout new QHBoxLayout; rowLayout-addWidget(new QLabel(配置路径:)); rowLayout-addWidget(new QLineEdit, 1); // 第二个参数 1 是拉伸因子输入框占满剩余空间 rowLayout-addWidget(new QPushButton(浏览)); // 多行之间用垂直布局串起来最后设给中央部件 QVBoxLayout *mainLayout new QVBoxLayout; mainLayout-addLayout(rowLayout); mainLayout-addStretch(); // 底部加弹簧把内容顶上去 ui-centralWidget-setLayout(mainLayout);参数说明addWidget 的第二个参数是 stretch默认 0给 1 表示该控件在剩余空间里按比例分配addStretch 插入一个可伸缩空白用来把上面的内容压到顶部。网格布局 QGridLayout 用 addWidget(widget, row, column, rowSpan, columnSpan) 定位适合表单类界面。注意布局一旦设给某个父部件就不要再用 setGeometry 去动子控件两者会打架表现为控件位置跳来跳去。3.3 托盘菜单与多窗体调用两个高频需求的落地第三章 1.22 的任务栏托盘菜单和第二章 1.7 的多窗体调用是实际项目里问得最多的两个点。托盘菜单的核心是 QSystemTrayIcon需要先判断系统是否支持再挂菜单和激活信号// 构造托盘图标父对象设 this 让 Qt 管生命周期 trayIcon new QSystemTrayIcon(this); trayIcon-setIcon(QIcon(:/res/app.ico)); trayIcon-setToolTip(后台服务运行中); // 挂右键菜单 QMenu *trayMenu new QMenu(this); trayMenu-addAction(显示主窗口, this, MainWindow::showNormal); trayMenu-addAction(退出, qApp, QApplication::quit); trayIcon-setContextMenu(trayMenu); // 单击托盘图标恢复窗口双击同理 connect(trayIcon, QSystemTrayIcon::activated, this, [this](QSystemTrayIcon::ActivationReason reason){ if (reason QSystemTrayIcon::Trigger) showNormal(); }); trayIcon-show();逻辑上activated 信号带一个枚举参数说明触发方式单击、双击、中键等用 lambda 接住再判断比给每种方式单独连槽清爽。多窗体调用则要注意用 new 出来的子窗口如果 parent 设为 this关闭时只是隐藏不销毁反复打开会越积越多不想保留就设setAttribute(Qt::WA_DeleteOnClose)或者用栈对象 show 后 exec。范例里两种写法可能都有改的时候按“这个窗口要不要复用”来定。4. 文件、绘图与数据库范例里最容易踩坑的三块4.1 文件与 INI/XML路径和编码是两个隐形雷第五章的文件操作和 INI/XML 读写代码本身不长坑集中在路径和编码。QFile 用相对路径时基准是进程当前工作目录不是 exe 所在目录IDE 里跑和双击 exe 跑结果可能不一样。稳妥做法是用 QCoreApplication::applicationDirPath() 拼绝对路径。INI 读写用 QSettings注意第二个参数要显式给 QSettings::IniFormat否则 Windows 下默认写注册表// 显式指定 IniFormat路径用应用目录拼避免工作目录不一致 QString iniPath QCoreApplication::applicationDirPath() /config.ini; QSettings settings(iniPath, QSettings::IniFormat); settings.setIniCodec(UTF-8); // Qt5 下中文必须设编码否则乱码 settings.setValue(network/port, 8080); settings.sync(); // 立即落盘别等析构 int port settings.value(network/port, 8080).toInt();参数说明setIniCodec 在 Qt5 里有效Qt6 已移除该接口、默认 UTF-8sync() 强制写盘程序异常退出时没 sync 的数据会丢。XML 那两节用 QDomDocument读的时候注意 elementsByTagName 返回的是所有同名节点要按层级逐层找别指望一次拿到深层节点。4.2 QPainter 绘图抗锯齿和坐标变换的顺序第六章图形图像操作是这份资料里比较有含金量的一块绘制文字、线条、椭圆、图片缩放翻转、模糊着色阴影都覆盖了。QPainter 的关键是理解坐标系和状态栈。缩放、旋转、平移都会改变后续绘制的坐标系画完要 save/restore 配对否则影响后面的绘制void Widget::paintEvent(QPaintEvent *) { QPainter p(this); p.setRenderHint(QPainter::Antialiasing, true); // 抗锯齿线条才不毛糙 p.save(); // 保存当前坐标系状态 p.translate(100, 100); // 原点移到 (100,100) p.rotate(45); // 绕新原点旋转 45 度 p.drawRect(-50, -50, 100, 100); // 画一个居中的方块 p.restore(); // 恢复后续绘制不受影响 p.drawText(20, 20, 正常坐标系下的文字); }逻辑说明save/restore 是栈操作必须成对漏了 restore 会让后面的绘制全部带着旋转平移表现为“越画越偏”。抗锯齿对线条和文字效果明显但对大图片缩放会拖性能按需开。图片缩放用 scaled() 返回新 QPixmap注意保持宽高比否则图片变形模糊、着色、阴影这些效果在 Qt5 里可以用 QGraphicsBlurEffect 等效果类也可以自己用 QImage 逐像素处理范例里两种思路可能都有性能敏感的场景优先用效果类。4.3 SQLite 与 QThread连接不能跨线程这是硬约束第十章数据库和第十二章进程线程单独看都不难合在一起就是经典翻车现场在主线程建了 QSqlDatabase 连接丢到 QThread 里查询报 “QSqlDatabasePrivate::database: requested database does not belong to the calling thread”。Qt 的数据库连接是线程绑定的每个线程要自己建连接连接名还得不同// 在工作线程的 run() 或槽里创建本线程专属连接 void Worker::doQuery() { // 连接名带上线程 id保证唯一 QString connName QString(worker_%1) .arg(reinterpret_castquintptr(QThread::currentThreadId())); QSqlDatabase db QSqlDatabase::addDatabase(QSQLITE, connName); db.setDatabaseName(data.db); if (!db.open()) { /* 记录错误并返回 */ } QSqlQuery q(db); q.exec(SELECT * FROM records); // 用完关闭并从连接池移除否则连接名会越积越多 db.close(); QSqlDatabase::removeDatabase(connName); }参数说明addDatabase 的第二个参数是连接名不传就用默认连接多线程下必然冲突removeDatabase 要在所有 QSqlQuery 析构之后调用否则会警告“connection is still in use”。QThread 的用法上范例里 1.2 是继承 QThread 重写 run1.3 是 QRunnable 配合线程池前者适合长驻任务后者适合短任务批量跑。我一般优先用 moveToThread 的 worker 对象模式信号槽跨线程自动排队比继承 QThread 少踩坑。5. 避坑排查拆这份范例时最常翻的五个车5.1 编译过了运行报 “driver not loaded”现象数据库范例编译链接都正常一运行 open() 返回 false控制台提示 QSqlDatabase: QSQLITE driver not loaded。原因Qt 的 SQL 驱动是插件形式exe 目录下缺 sqldrivers 文件夹或者安装时没勾对应驱动。解决从 Qt 安装目录的 plugins/sqldrivers 把 qsqlite.dll 拷到 exe 同级 sqldrivers 目录用 windeployqt 工具会自动带再不行用QSqlDatabase::drivers()打印当前可用驱动确认。5.2 中文乱码界面和文件两头都乱现象源码里写的中文在界面显示成问号或者写进 INI/文本文件打开是乱码。原因Qt5 默认按 UTF-8 处理源码但 MSVC 编译器对无 BOM 的 UTF-8 源文件可能按本地编码解析文件读写没设编码。解决源文件统一存 UTF-8 带 BOMMSVC 下最稳或在 .pro 加QMAKE_CXXFLAGS /utf-8QTextStream 读写显式 setCodec(“UTF-8”)QSettings 设 setIniCodec。5.3 无边框窗体拖不动或拖动时窗口跳变现象照第二章 1.5 做了无边框窗体鼠标拖动时窗口位置乱跳或者只能拖一下。原因mouseMoveEvent 里用的是全局坐标减窗口左上角但没记录按下时的偏移量或者没判断左键是否按下。解决在 mousePressEvent 里存dragPos e-globalPos() - frameGeometry().topLeft()move 事件里判断e-buttons() Qt::LeftButton再move(e-globalPos() - dragPos)释放时清状态。5.4 打包后 exe 在别人机器上缺 DLL现象本机跑得好好的拷到客户机器双击报缺少 Qt5Core.dll 或平台插件 windows 找不到。原因只拷了 exe没带 Qt 运行库和 platforms 插件。解决用 Qt 自带的 windeployqt 对 exe 跑一遍自动收集依赖第十四章的 FilePacker 和 Inno Setup 是在此基础上做安装包顺序不能反——先 windeployqt 补齐依赖再打包否则装完照样起不来。5.5 定时器更新界面卡顿或时间不准现象第四章 1.6 用 QTimer 实时更新时间跑久了界面卡或者秒数跳变不均匀。原因定时器精度受事件循环负载影响interval 设太小比如 10ms又做重活事件队列堆积。解决刷新界面用 1000ms 足够重活丢到工作线程需要高精度计时用 QElapsedTimer 算差值而不是累加定时器次数。6. 从范例到项目我的二次封装习惯拆完这份资料真正让它产生价值的不是把例子跑一遍而是把重复出现的模式抽成自己的小工具。我一般会做三件事。第一建一个 base 目录把无边框窗体拖动、托盘图标初始化、INI 配置读写这三段封装成基类和工具函数后面每个新工程直接拷过去省掉每次重写。第二给每个范例工程加一个 README 记录“这个例子在 Qt 5.15 下改了什么”比如老式 connect 换成新式、QDesktopWidget 换成 QScreen下次再拆同类资源时直接对照。第三用一张表管理范例与需求的映射避免在二十多个控件例子里迷路需求场景对应范例章节迁移注意点主窗口带菜单工具栏第2章 窗体基类选 QMainWindow别用 QWidget登录/设置弹窗第4章 登录窗口QDialog exec注意返回值配置持久化第5章 INI 读写显式 IniFormat UTF-8后台任务不卡界面第12章 QThread数据库连接按线程建发布给客户第14章 打包先 windeployqt 再 Inno Setup验证一个范例是否真的吃透我的标准是把它改成一个自己项目里的小功能能编译、能跑、异常路径也走过一遍。比如把点对点聊天那两节改成局域网内一对多的消息广播中间会逼你处理粘包、连接断开重连、线程安全发消息这些是光看范例看不出来的。从那以后我每次拆这类范例包都强制自己先跑通命令行构建、再改一个真实小需求、最后用 windeployqt 打一次包三步走完才算这份资源真正落地。希望帮到你。本文还有配套的精品资源点击获取