第1章：Qt内存模型：对象树机制、QObject父子关系、自动内存管理原理

大家好，我是老张。今天咱们来聊聊Qt最核心的内存管理机制——对象树。说实话，我见过太多新手在Qt里栽在内存泄漏上，其实搞懂了对象树，这些问题基本都能避免。

1.1 为什么需要对象树？

C++本身没有垃圾回收，你得自己管内存。但Qt里到处都是new出来的控件、对话框、线程对象……一个个手动delete？太累了，而且容易漏。

Qt的解决方案很聪明：让对象自己管自己。怎么管？靠父子关系。

你想想看，一个窗口关闭时，它上面的按钮、标签、输入框是不是都应该跟着销毁？Qt的对象树机制就是干这个的。

核心思想：每个QObject都可以有一个父对象。父对象销毁时，会自动销毁所有子对象。这就形成了一棵树——对象树。

1.2 QObject父子关系怎么建立？

有两种方式：

构造时指定父对象：QPushButton *btn = new QPushButton("确定", this);
运行时设置父对象：obj->setParent(parent);

我个人习惯用第一种，代码更清晰。来看个例子：

// 构造时指定父对象
QWidget *window = new QWidget;
QPushButton *btn = new QPushButton("点击我", window);  // btn的父对象是window
QLabel *label = new QLabel("Hello", window);           // label的父对象也是window

// 运行时设置父对象
QTimer *timer = new QTimer;
timer->setParent(window);  // 现在timer也归window管了

// 当window销毁时，btn、label、timer都会自动销毁
delete window;  // 一删全删，干净利落

嗯，这里要注意：父对象必须是QObject或其子类。普通C++类不行。

1.3 自动内存管理原理

说白了，Qt在QObject内部维护了一个子对象列表。当父对象析构时，会遍历这个列表，挨个delete每个子对象。

伪代码大概是这样的：

QObject::~QObject() {
    // 1. 发出销毁信号
    emit destroyed(this);
    
    // 2. 删除所有子对象
    for (QObject *child : m_children) {
        delete child;  // 递归删除
    }
    
    // 3. 从父对象的子列表中移除自己
    if (m_parent) {
        m_parent->removeChild(this);
    }
}

我在项目中遇到过一个问题：有人手动delete了一个子对象，但没从父对象的子列表中移除。结果父对象析构时又delete了一次，直接崩溃。所以记住：要么交给Qt管，要么自己管到底，别混着来。

避坑指南：我曾经在项目里看到有人这样写：

delete childObj;  // 手动删除
// 忘记调用 childObj->setParent(nullptr);

后果就是double free，程序直接挂掉。正确的做法是：

childObj->setParent(nullptr);  // 先解除父子关系
delete childObj;                // 再手动删除

或者干脆别手动删，让Qt自动处理。

1.4 对象树的可视化

为了让你更直观地理解，我画了一张对象树的结构图：

这张图很直观：QApplication是根，MainWindow是它的子对象，而MainWindow下面又挂着按钮、标签、布局等子对象。布局下面还有输入框和下拉框。销毁时从根开始，一层层往下删。

1.5 对象树的好处

特性	说明	我的经验
自动内存管理	父对象销毁时自动删除所有子对象	省去了大量手动delete代码，减少内存泄漏
事件传递	事件可以从子对象向上冒泡到父对象	做自定义事件处理时特别有用
类型查询	可以通过parent()、children()遍历对象树	调试时我经常用dumpObjectTree()查看结构
线程安全	同一对象树中的对象建议在同一个线程操作	跨线程操作父对象时容易出问题，要注意

小技巧：调试时可以用这个代码打印对象树：

// 在任意QObject上调用
obj->dumpObjectTree();  // 打印整个对象树结构
obj->dumpObjectInfo();  // 打印对象信号槽连接信息

我每次排查内存问题时，第一件事就是调dumpObjectTree，看看对象树是不是我预期的样子。

1.6 常见误区

最后说几个我经常看到的坑：

误区一：以为new出来的QObject必须手动delete。其实只要设置了父对象，就不用管了。
误区二：在栈上创建QObject然后设置父对象。比如QPushButton btn(this);——这会导致double free，因为栈对象离开作用域会自动析构，父对象析构时又会delete一次。
误区三：跨线程传递QObject指针。不同线程的对象树是独立的，别混用。

嗯，关于对象树机制，今天就聊这么多。搞懂了这些，Qt内存管理这块你就掌握了八成。剩下的两成，咱们后面章节慢慢聊。