企业官网建设流程全解析

重学 Qt 的第二站，几乎都会落在常用控件上。Qt 自带的控件种类远不止 QPushButton、QLabel 这几样，但如果只是逐个控件试属性，学完两周后很容易发现自己只是记住了 API 名，遇到一个带输入框、下拉框和表格的窗口仍然不知道代码该怎么组织。这里按“从零一行行写代码”的学习路线，把 Qt 常用控件这条线整理出来：先弄懂控件所在的对象树和信号槽是怎么工作的，再搭建一个最小 Qt Widgets 工程，然后把章节里 14 讲的内容拆成几组，最后用一个能编译、能运行、能继续扩展的客户登记窗口把常用控件串起来。

读完并按示例操作后，你能独立完成三类事情：第一，新建一个普通 Qt Widgets 工程并手写界面代码，而不是只会在 Designer 里拖控件；第二，知道 QLabel、QPushButton、QLineEdit、QComboBox、QTableWidget 这类高频控件的常用接口，以及“用户操作后如何拿到值”；第三，遇到按钮没反应、控件布局乱、运行时报平台插件错误这类问题，能按日志和现象定位根因。

1. 别急着背控件，先把对象树和信号槽这两条主线打通

1.1 控件本质：QWidget、QObject 与对象树

Qt Widgets 模块里，几乎所有可见控件都继承自 QWidget。QWidget 又继承自 QObject，所以控件不是一堆互不相干的 C++ 类，而是挂在一棵对象树上的节点。

这里的“父子关系”有两层含义。第一层是窗口包含关系：子控件默认显示在父控件的客户区里，父控件移动、隐藏、销毁时，子控件跟着移动、隐藏、销毁。第二层是内存释放关系：QObject 的析构函数会递归删除所有子对象。也就是说，一个挂到父对象上的 QPushButton，通常不需要手动 delete，父对象销毁时会统一处理。

理解这一点对写代码影响很大。一个典型错误写法是：

QPushButton *button = new QPushButton; // 没有父对象，也没有布局管理 button->show();

这个按钮虽然会被显示，但如果不把指针保存起来，后续既拿不到它，也容易忘记释放，程序结束时变成野内存或泄漏。推荐做法是创建时直接指定父对象，或者把它交给布局管理：

QWidget window; QPushButton *button = new QPushButton(QStringLiteral("确定"), &window);

这里把&window传进构造函数的parent参数，按钮就成为 window 的子控件。当 window 离开作用域析构时，Qt 会先析构子对象。需要注意的是，如果用栈对象作为父对象，子对象必须使用堆对象，并且父对象析构顺序要晚于子对象使用结束，否则会出现悬空访问。

对象树的另一层作用是分类管理。单个窗口里可以有 QGroupBox、QTabWidget、QStackedWidget 这样的容器控件，容器也是一层层嵌套的 QWidget 节点。学习常用控件时，先看控件在对象树里的位置，再看它有多少属性和接口，能减少很多混乱。

1.2 控件之间靠信号槽，不靠互相保存指针

控件之间要做交互，最常见的手段是信号与槽。信号表示“某件事发生了”，槽表示“某件事要执行”，QObject::connect 负责把两者连接起来。

Qt 5 之后推荐使用的是“函数指针”写法，编译期就能检查连接是否成立：

#include <QApplication> #include <QWidget> #include <QLabel> #include <QPushButton> int main(int argc, char *argv[]) { QApplication app(argc, argv); QWidget window; window.setWindowTitle(QStringLiteral("信号槽最小示例")); window.resize(400, 300); QLabel *label = new QLabel(QStringLiteral("标签"), &window); label->setGeometry(150, 80, 100, 30); QPushButton *button = new QPushButton(QStringLiteral("清空文本"), &window); button->setGeometry(140, 160, 120, 32); QObject::connect(button, &QPushButton::clicked, label, &QLabel::clear); window.show(); return app.exec(); }

上面的例子中，点击 button，label 的文本会被清空。connect 的第三个参数是接收者对象，第四个参数是接收者成员函数，也就是槽。这个写法的好处是：如果 clicked 信号和 clear 槽的参数不匹配，编译阶段就会报错，不用运行到一半才暴露问题。

有些老资料和旧代码使用宏写法：

connect(button, SIGNAL(clicked()), label, SLOT(clear()));

这种写法运行时才解析字符串，如果类名拼错、函数签名写错，编译器不会及时提示。新项目建议使用函数指针写法。

还有一类问题是信号存在重载。比如 QComboBox 的 currentIndexChanged 既有int版本，也有QString版本。Qt 5 中连接重载信号需要帮助编译器区分：

connect(combo, qOverload<int>(&QComboBox::currentIndexChanged), this, [](int index) { qDebug() << "当前索引" << index; });

如果不加qOverload<int>直接写&QComboBox::currentIndexChanged，编译器可能因为无法确定重载版本而直接报错。这里也解释了一个常见问题：为什么照着资料写 connect，有时会编译失败。

2. 先确认学习环境，再搭一个最小控件工程

2.1 Qt 版本与编译器要先对齐

常用控件这一章有一个优势：不需要数据库、网络、多线程这些额外依赖，环境越简单越容易跑通。入门阶段使用的 Qt 版本会影响编译器选择和个别 API，因此开始前要确认三件事：Qt 版本、编译器工具链、工程构建方式。

很多学习资料现在仍围绕 Qt 5.15.2 编写，也有一部分已经切到 Qt 6。如果跟随一套基于 Qt 5 的课程或源码学习，先不要急着装最新版，最好先看课程开头说明使用的版本，否则 QML、模块划分、某些枚举名可能会对不上。以 Qt Widgets 为例，从 Qt 5 到 Qt 6 的改动相对较小，但QRegExp、QTextCodec、部分枚举在 Qt 6 中已经被调整或移除，查资料时要注意来源版本。

下面是一份典型的学习环境参考：

| 项目 | 建议值 | 说明 | | --- | --- |