1. 代码开发工具选 Qt 5.9:先跑配套工程,别从截图开始
很多人把 Qt 5.9 当成一个装完就能用的代码开发工具,拿到配套代码先翻 PDF 截图,结果 qmake 一跑就报错,窗口刚弹出来就闪退。我的建议反过来:先把每个章节子目录当成独立工程跑通,再回头读信号槽和事件循环。Qt 5.9 这套 C++ 桌面开发链路,真正值得上手的是可编译的工程,不是截图。它适合刚接触 Qt 的开发者,也适合要做课程设计或内部小工具、又不想啃官方文档的人。下面按我实际带人跑过的顺序:装环境、开工程、接信号槽、排构建错误、再加一个自己的绘图面板。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 代码开发工具的环境落地:Qt Creator、qmake 与构建套件
Qt 5.9 的配套代码有个特点:每个章节子目录都是一个独立工程,能单独编译、单独改。环境没落地之前,先别急着读信号槽源码,先把一个子工程的 .pro 找到,让 Qt Creator 和命令行各构建成功一次。代码开发工具一旦配错,后面所有报错都会长得像业务问题。
2.1 先认 .pro:配套代码的工程入口
Qt 工程里,.pro 是 qmake 的工程描述文件,源文件、头文件、模块依赖、目标名都从这里读。配套代码按章节拆成子目录后,每个子目录里应该有一个 .pro,而不是整个仓库只有一个总工程。第一步不是打开 Qt Creator,而是进到某个章节目录,确认 .pro 就在当前目录。
bash复制# 进入某个章节工程目录,确认 .pro 就在当前目录
ls *.pro
# 用 qmake 读取 .pro,生成 Makefile
qmake Chapter01.pro
# 用生成的 Makefile 编译
make
ls *.pro 只是确认入口在哪,避免在仓库根目录乱跑 qmake。qmake Chapter01.pro 里的文件名要换成你当前子目录里真实存在的那个;如果路径里有空格,用引号包住。make 读取 qmake 刚生成的 Makefile,做增量编译。Windows 下 make 的名字可能跟套件走,常见是 Qt Creator 构建套件里配置的那个 make 工具,命令行里别随手拿一个别的 make 顶上。
注意:qmake 和 make 要在同一个构建目录里执行,源码目录和影子构建目录不要混着用。
这一步跑通的标准不是“终端没红字”,而是当前目录或构建目录里出现了可执行产物,并且能启动。如果 qmake 报找不到文件,先看 pwd 和 ls *.pro,不要直接去改 .pro 内容。
2.2 在 Qt Creator 里选对构建套件
命令行能过,Qt Creator 里仍然可能构建失败,差别通常在构建套件。Qt Creator 的套件把 Qt 版本、编译器、调试器绑在一起,三者对不上时,编辑器能打开代码,构建却会报一堆看不懂的错。打开 .pro 后,先看左下角套件选择,再看“工具-选项-构建与运行”里套件前面有没有警告。
| 检查项 | 看什么 | 不对时怎么办 |
|---|---|---|
| Qt 版本 | 套件绑定的 Qt 是不是你要用的 Qt 5.9 | 在套件里重新选 Qt 版本 |
| 编译器 | 套件里的编译器是否可用 | 重新检测或换已安装的编译器 |
| 构建目录 | 是否和源码目录分开 | 用影子构建,别在源码目录里堆产物 |
我一般会先做一次“清理再构建”,确认不是旧产物在骗人。构建目录建议单独放在源码目录外面,名字里带工程名,方便后面排错时整个删掉重来。Qt Creator 默认会做影子构建,但有人手动改过构建目录,后面就会出现“改了代码还是旧行为”的玄学。
套件选对后,先点 qmake,再点构建,最后运行。不要跳过 qmake 直接构建,尤其是刚从命令行切回 Qt Creator 的时候,Makefile 可能还是上一套环境生成的。
2.3 命令行 qmake 与 make 的最小闭环
Qt Creator 的图形界面方便,但排构建问题时,命令行更干净。它能把 Qt Creator 缓存、套件选择、旧构建目录这些干扰先排除掉。做法是进到 .pro 所在目录,先 qmake 再 make,最后直接运行产物。
bash复制# 在 .pro 所在目录执行,先清掉旧构建产物再生成 Makefile
qmake Chapter01.pro
make
# 运行产物;Windows 下带 .exe,Linux/macOS 下直接执行
./Chapter01
qmake 只负责生成 Makefile,不负责编译;make 才编译。运行名来自 .pro 里的 TARGET,示例里的 Chapter01 要换成你自己的目标名。如果 qmake 成功但 make 失败,问题通常在编译器、头文件路径或依赖库;如果 make 成功但运行闪退,问题往后移到运行时依赖和事件循环。这个分界线很有用,别把编译错误和运行错误混在一起猜。
命令行跑通后,再回 Qt Creator 用同一套 qmake 和编译器构建。两边结果不一致时,优先信命令行,因为它的输入最少。把这条闭环走顺,后面接信号槽和加模块才有稳定的底座。
3. 信号槽和事件循环:Qt 5.9 里把按钮接进窗口
信号槽不是普通函数回调,它把“谁发生了什么”和“谁来处理”拆成两个对象。事件循环则是窗口能持续响应的前提:没有 app.exec(),窗口显示出来也会很快退出。把这两件事分开看,排错时就不会把“没反应”全归到信号槽上。
3.1 信号槽不是回调:对象、信号、槽三件事
信号槽的参与者是 QObject 派生对象。发送者声明信号,接收者声明槽,connect 把两边连起来。Qt 5 的新语法直接把函数地址传进去,拼写错误在编译期就能暴露,比旧式字符串连接稳。
cpp复制// mywindow.h
#pragma once
#include <QWidget>
class QPushButton;
class MyWindow : public QWidget {
Q_OBJECT
public:
explicit MyWindow(QWidget *parent = nullptr);
private slots:
void onButtonClicked();
private:
QPushButton *button;
int clickCount;
};
Q_OBJECT 宏让 moc 生成元对象代码,信号槽机制依赖它;漏掉这个宏,connect 可能编译过但运行时不生效。private slots 在 Qt 5 新语法下不是硬性要求,但保留它能让人一眼看出这是槽函数。QPushButton 用前置声明,头文件里不拖进控件头,编译依赖更干净。clickCount 是给后面绘图用的状态,初始值在构造函数里设成 0。
这里的关键不是背宏,而是分清“信号属于发送者、槽属于接收者”。按钮的 clicked 信号属于按钮对象,窗口的 onButtonClicked 槽属于窗口对象,connect 只是把两者接起来。对象生命周期一旦错位,连接就会失效,后面排查会细说。
3.2 把按钮点击接到窗口槽函数
连接动作放在窗口构造函数里,按钮创建之后、窗口显示之前。槽函数里只做业务状态更新,再请求重绘,不要把耗时的文件读写或阻塞循环塞进去。
cpp复制#include "mywindow.h"
#include <QPushButton>
MyWindow::MyWindow(QWidget *parent) : QWidget(parent), clickCount(0) {
button = new QPushButton("点我", this);
button->setGeometry(20, 20, 120, 40);
// 新语法:信号取地址,槽取地址,编译期能查出拼写错误
connect(button, &QPushButton::clicked, this, &MyWindow::onButtonClicked);
}
void MyWindow::onButtonClicked() {
++clickCount;
update(); // 请求重绘,不是立刻画
}
connect 的四个参数依次是发送者、信号、接收者、槽。clicked 信号没有参数,所以槽函数也不带参数;如果信号带参数,槽函数参数要能匹配。this 作为接收者,表示槽在窗口对象上执行。update() 只是投递一个重绘请求,真正绘制发生在事件循环处理绘制事件时,不是这一行立刻画完。
调试阶段可以把 connect 的返回值接住,connect 返回 bool,失败时别让它静默过去。按钮的 setGeometry 参数是 x、y、宽、高,示例值只是让按钮可见,实际界面按你的布局来。用布局管理器会更稳,但初学阶段先用固定位置把链路跑通,能少一层干扰。
3.3 事件循环和绘图刷新时机
窗口能响应点击,靠的是 QApplication::exec() 进入事件循环。事件循环不断取事件、分发事件:点击进到按钮,按钮发信号,信号触发槽,槽里调用 update(),重绘事件再回到窗口的 paintEvent。
cpp复制#include <QApplication>
#include "mywindow.h"
int main(int argc, char *argv[]) {
QApplication app(argc, argv);
MyWindow window;
window.resize(320, 240);
window.show();
return app.exec(); // 事件循环,窗口才能持续响应
}
app.exec() 是阻塞调用,它不返回,直到窗口退出。有人为了“让窗口显示”写成 window.show(); return 0;,结果窗口一闪就没了,看起来像闪退,其实是没进事件循环。show() 只是请求显示,resize 设置初始大小,参数按你的界面调整。
绘图不要在槽函数里直接拿 QPainter 画到窗口上,窗口的绘制统一放到 paintEvent。槽里改状态、调 update(),绘制时再读状态。这样事件循环、信号槽、绘图系统三者的顺序才是清楚的,后面加绘图面板也顺着这个节奏走。
4. 代码开发工具的构建排查:qmake 报错与窗口闪退
Qt 5.9 配套代码的坑多在前置条件,不在业务代码。qmake 报错、窗口闪退、信号槽没反应、改了代码还是旧行为,这四类现象看起来都像“Qt 坏了”,其实分层很清楚。排查时先问一句:现在卡在生成 Makefile、编译、启动,还是事件分发。
4.1 qmake 报错先看当前目录和 .pro 路径
现象:终端执行 qmake 后提示找不到文件,或者 qmake 读不到工程。原因通常不是 Qt 坏了,而是当前目录不对,或者 .pro 路径里有空格、中文,或者文件名写错。配套代码按章节拆目录,很容易在仓库根目录直接 qmake,根目录没有子工程的 .pro。
bash复制# 先确认当前目录里到底有没有 .pro
pwd
ls *.pro
# 有空格或中文的路径先用引号包住,能搬就搬到纯英文短路径
qmake "Chapter01.pro"
解决顺序是:pwd 看当前在哪,ls *.pro 看入口在不在,再用引号包住带空格或中文的路径。能搬到纯英文短路径就搬,Qt 5.9 时代不少构建问题跟路径字符有关。qmake 的输入是 .pro,输出是 Makefile;qmake 报错时不要先去改源码,先让 .pro 被正确读到。
4.2 窗口闪退先分清启动失败还是业务崩溃
现象:窗口刚弹出来就消失,或者压根没看到窗口。原因分两类:启动阶段没进事件循环,或者构造函数里异常、运行时缺平台插件或依赖库。先看 main 最后是不是 return app.exec(),再看 Qt Creator 的应用输出最后几行。
cpp复制int main(int argc, char *argv[]) {
QApplication app(argc, argv);
MyWindow window;
window.show();
return app.exec(); // 这里返回 0 而不是 exec,窗口会立刻退出
}
如果这里写成 return 0,窗口显示后事件循环没起来,程序直接结束,现象就是闪退。构造函数里如果做了重活或访问了未初始化对象,窗口也可能在显示前崩掉。运行依赖缺失时,Qt Creator 里可能能跑,直接双击产物却闪退,差别在库搜索路径。解决是把依赖库放到可执行文件旁,或把库路径加进运行环境,别靠“再点一次”碰运气。
4.3 信号槽不生效的检查顺序
现象:按钮能点,但槽函数没执行,界面没变化。原因可能是 connect 失败、接收者对象提前析构、信号根本没触发,或者槽函数执行了但没调用 update()。检查顺序从 connect 返回值开始,再到对象生命周期,最后看绘制刷新。
cpp复制bool ok = connect(button, &QPushButton::clicked, this, &MyWindow::onButtonClicked);
qDebug() << "connect ok:" << ok;
connect 返回 false 时,先检查信号和槽的签名是否匹配,再检查 Q_OBJECT 宏有没有漏。返回 true 但没反应,就在槽函数里打日志,确认它到底进没进。接收者如果是临时对象,连接建立后对象被销毁,信号到了也没有活着的接收者。槽里改了状态但界面不动,通常是忘了 update(),或者绘制逻辑没读这个状态。
4.4 构建目录混用和绘图不刷新
现象:代码改了,运行出来还是旧行为;或者点击后计数变了,矩形没变。原因常见是源码目录和影子构建目录来回切,旧 Makefile 和旧产物混在一起;绘图不刷新则是只改了成员变量,没有请求重绘。
bash复制# 确认构建目录,不要直接在源码目录里反复 qmake 和 make
rm -rf build-Chapter01
qmake Chapter01.pro
make
把构建目录整个删掉再 qmake,能排除旧 Makefile 和旧对象文件的干扰。构建目录名按你的工程改,别照抄示例。绘图不刷新时,检查槽函数里有没有 update(),以及 paintEvent 里读的是不是同一个成员变量。Qt 的绘制由事件循环调度,update() 是请求,不是同步调用;连续多次调用会被合并,这是正常行为。
提示:connect 返回 bool,调试阶段别丢掉这个返回值。
5. 在配套工程里加自己的模块:绘图面板与验证习惯
加模块不要塞进主窗口构造函数里,先让绘图面板独立成一个可重写的 paintEvent,再用状态驱动它。这样信号槽、事件循环、绘图三条链路仍然分开,出问题时能一段一段验证。
5.1 加一个 QPainter 面板
在窗口类里重写 paintEvent,用 clickCount 驱动文字和矩形宽度。绘制代码只读状态,不修改状态,状态修改仍然留在槽函数里。
cpp复制// mywindow.cpp 里重写 paintEvent
void MyWindow::paintEvent(QPaintEvent *event) {
QWidget::paintEvent(event);
QPainter painter(this);
painter.drawText(20, 80, QString("clickCount: %1").arg(clickCount));
painter.drawRect(20
