Qt 基础：QObject 体系、对象树与内存管理
这一章是 Qt 的灵魂。理解了对象树，你就再也不会为 Qt 的内存管理头疼。
一、QObject 体系
1.1 什么是 QObject
QObject是 Qt 所有类的基类，提供了 Qt 的核心特性：
- 信号与槽（Signal/Slot）
- 对象树（父子关系内存管理）
- 事件处理（event、eventFilter）
- 定时器（startTimer）
- 国际化（tr()）
- 属性系统（Q_PROPERTY）
- 对象名称（objectName）
1.2 继承关系
QObject ├── QWidget（所有控件的基类） │ ├── QPushButton │ ├── QLabel │ ├── QLineEdit │ ├── QMainWindow │ └── QDialog ├── QTimer ├── QThread ├── QTcpSocket └── ...（几乎所有 Qt 类都继承自 QObject）1.3 Q_OBJECT 宏
#include<QObject>/** * @brief 自定义 QObject 子类 * * 只要类中用到信号槽、tr()、Q_PROPERTY 等，就必须加 Q_OBJECT 宏。 * 加了 Q_OBJECT 的类会被 moc（Meta-Object Compiler）预处理器处理， * 生成 moc_xxx.cpp 文件，实现元对象系统。 */classMyObject:publicQObject{Q_OBJECT// 必须放在类体的最开头（private 区域之前）public:explicitMyObject(QObject*parent=nullptr):QObject(parent){}};常见坑：加了 Q_OBJECT 但编译报错 “undefined reference to vtable”，通常是因为没有重新运行 qmake/CMake，或者 moc 没有生成对应文件。删除 build 目录重新构建即可。
二、对象树机制
2.1 核心思想
每个 QObject 都可以有一个父对象和多个子对象，形成一棵树。当父对象被销毁时，它会自动销毁所有子对象。
QMainWindow (root) ├── QMenuBar │ ├── QMenu("文件") │ └── QMenu("编辑") ├── QToolBar ├── QTextEdit (centralWidget) └── QStatusBar └── QLabel("就绪")当QMainWindow关闭时，上面所有子对象会被递归自动 delete，不需要手动释放。
2.2 设置父子关系的三种方式
#include<QWidget>#include<QPushButton>/** * @brief 演示设置父子关系的三种方式 */voiddemoParentChild(){QWidget window;// 方式一：构造函数传 parent（最常用）QPushButton*btn1=newQPushButton("按钮1",&window);// 方式二：调用 setParentQPushButton*btn2=newQPushButton("按钮2");btn2->setParent(&window);// 方式三：加入布局（布局会自动设置父对象）QVBoxLayout*layout=newQVBoxLayout(&window);QPushButton*btn3=newQPushButton("按钮3");layout->addWidget(btn3);// btn3 的父对象自动变成 window// window 销毁时，btn1、btn2、btn3 全部自动释放}2.3 实战：正确的窗口类写法
// mainwindow.h#ifndefMAINWINDOW_H#defineMAINWINDOW_H#include<QMainWindow>classQPushButton;classQLabel;/** * @brief 主窗口类 * * 所有子控件都用指针，在构造函数中 new 并指定 this 为父对象。 * 不需要写析构函数释放它们，对象树会自动处理。 */classMainWindow:publicQMainWindow{Q_OBJECTpublic:/** * @brief 构造函数 * @param parent 父对象，默认为空（顶级窗口） */explicitMainWindow(QWidget*parent=nullptr);// 不需要写析构函数！对象树自动释放子控件。private:QPushButton*m_btn;///< 按钮QLabel*m_label;///< 标签};#endif// MAINWINDOW_H// mainwindow.cpp#include"mainwindow.h"#include<QPushButton>#include<QLabel>#include<QVBoxLayout>#include<QWidget>MainWindow::MainWindow(QWidget*parent):QMainWindow(parent){// 创建中心部件（QMainWindow 必须设置 centralWidget）QWidget*central=newQWidget(this);setCentralWidget(central);// 创建布局，父对象是 centralQVBoxLayout*layout=newQVBoxLayout(central);// 创建控件，父对象是 central（也可以不指定，加入布局后自动设置）m_label=newQLabel("欢迎使用 Qt",central);m_btn=newQPushButton("确定",central);layout->addWidget(m_label);layout->addWidget(m_btn);resize(400,300);}三、内存管理机制
3.1 Qt 的内存管理规则
| 场景 | 是否需要手动 delete |
|---|---|
| new 时指定了父对象的 QObject | 不需要，父对象销毁时自动释放 |
| 没有父对象的 QObject | 需要，或调用 deleteLater() |
| 非 QObject 对象（普通 C++ 类） | 需要，或用智能指针 |
| 栈上创建的对象（QWidget window;） | 不需要，离开作用域自动析构 |
3.2 deleteLater()：安全删除
#include<QObject>#include<QTimer>/** * @brief 演示 deleteLater 的正确用法 * * 不要在对象自己的事件处理函数中直接 delete this， * 因为事件循环可能还在访问这个对象。用 deleteLater() 延迟到事件循环空闲时删除。 */classSelfDestructor:publicQObject{Q_OBJECTpublic:voiddoSomethingAndDie(){qDebug()<<"做一些事情...";// delete this; // 危险！可能导致崩溃deleteLater();// 安全：等当前事件处理完再删除}};// 典型场景：网络请求完成后删除 reply// QNetworkReply *reply = manager.get(request);// connect(reply, &QNetworkReply::finished, reply, &QNetworkReply::deleteLater);3.3 常见内存错误与避免
错误一：栈上控件指定父对象
voidbadExample(){QWidget window;QPushButtonbtn("按钮",&window);// 危险！// btn 是栈对象，window 也是栈对象// 函数结束时，先析构 window（会尝试 delete btn），再析构 btn// 双重释放，崩溃！}正确做法：子控件用new在堆上创建。
voidgoodExample(){QWidget window;QPushButton*btn=newQPushButton("按钮",&window);// 正确// window 析构时 delete btn，btn 只析构一次}错误二：手动 delete 已有父对象的控件
voidbadDelete(){QWidget*window=newQWidget;QPushButton*btn=newQPushButton("按钮",window);deletebtn;// 手动删除deletewindow;// window 析构时又会尝试 delete btn，双重释放！}正确做法：要么不手动 delete，要么先btn->setParent(nullptr)再 delete。
错误三：父对象先于子对象手动删除
voidbadOrder(){QWidget*window=newQWidget;QPushButton*btn=newQPushButton("按钮",window);deletewindow;// 会自动 delete btn，btn 已经无效// 之后再访问 btn 就是野指针}3.4 对象树查询 API
#include<QObject>#include<QDebug>/** * @brief 演示对象树的查询操作 */voiddemoObjectTree(QObject*root){// 获取父对象QObject*parent=root->parent();// 获取所有直接子对象QObjectList children=root->children();qDebug()<<"子对象数量:"<<children.size();// 按 objectName 查找子对象（递归查找）root->setObjectName("root");QPushButton*btn=root->findChild<QPushButton*>("loginBtn");// 查找所有指定类型的子对象QList<QPushButton*>allBtns=root->findChildren<QPushButton*>();// 遍历所有子对象for(QObject*child:root->children()){qDebug()<<"子对象:"<<child->objectName()<<"类名:"<<child->metaObject()->className();}}四、元对象系统（Meta-Object）
Q_OBJECT 宏启用了 Qt 的元对象系统，运行时可以获取类的信息。
#include<QObject>#include<QMetaObject>#include<QDebug>/** * @brief 演示元对象系统的运行时信息 */voiddemoMetaObject(QObject*obj){// 获取类名qDebug()<<"类名:"<<obj->metaObject()->className();// 判断类型（安全的类型转换）if(obj->inherits("QWidget")){qDebug()<<"这是一个 QWidget";}// qobject_cast：Qt 的安全类型转换（不需要 RTTI）QWidget*widget=qobject_cast<QWidget*>(obj);if(widget){widget->setWindowTitle("转换成功");}// 获取对象名称obj->setObjectName("myObject");qDebug()<<"对象名:"<<obj->objectName();}qobject_cast 比 dynamic_cast 更好：不依赖 RTTI，速度更快，且在 Qt 对象树中更安全。前提是类必须有 Q_OBJECT 宏。
五、核心要点总结
- QObject 是 Qt 的根：所有控件、定时器、线程等都继承自它，提供信号槽、对象树、事件等核心能力。
- Q_OBJECT 宏必加：用到信号槽就必须加，加了之后要重新构建项目（moc 处理）。
- 对象树自动管内存：new 时指定父对象，父对象销毁时子对象自动释放，不要手动 delete 已有父对象的控件。
- 栈对象不要指定父对象：否则会双重释放崩溃。子控件一律 new 在堆上。
- deleteLater()：在事件处理函数中删除对象时用它，不要直接 delete。
- qobject_cast：Qt 的安全类型转换，替代 dynamic_cast。
- findChild / findChildren：按 objectName 或类型查找子对象，UI 测试和动态界面常用。
- 构造函数参数
QObject *parent = nullptr：QObject 子类的标准写法，支持对象树。
下一章：核心机制 - 信号与槽与事件
