Qt 对象树与内存管理

Qt 提供了基于 QObject 的父子对象树机制，实现了半自动的内存管理，极大简化了 C++ 的内存释放问题。

---

1. 核心机制

在创建 QObject 及其派生类（如 QWidget、QPushButton 等）时，可以通过构造函数指定 parent。

• 生命周期管理：当父对象被销毁（delete）时，Qt 引擎会自动遍历其所有的子对象，并依次安全地销毁它们。这避免了内存泄漏的风险。

---

2. 绝对避坑指南

如果一个对象在创建时指定了 parent，必须用 new 将其分配在堆上，严禁在栈上分配。

void MyWidget::createUI() {
    // 错误：btn 分配在栈上，但被加入到了 this 的对象树中
    QPushButton btn("Click Me", this); 
    
    // 函数结束时，btn 离开作用域被栈自动销毁。
    // 当 this（父对象）被销毁时，又会尝试去 delete btn，导致崩溃！
}

void MyWidget::createUI() {
    // 正确：分配在堆上。无需手动 delete，this 被销毁时会自动释放 btn。
    QPushButton* btn = new QPushButton("Click Me", this);
}

[!WARNING]
将带有 parent 的对象分配在栈上是导致 Qt 应用程序产生 Double Free 崩溃的最常见原因之一。

---

3. QPointer (防野指针弱引用)

QPointer 是 Qt 专门针对 QObject 设计的弱引用指针。

• 作用：当它指向的 QObject 被销毁时，QPointer 会自动将自己置为 nullptr，有效避免野指针导致崩溃。

#include <QPointer>
#include <QMainWindow>

class ToolWindow : public QWidget {
    Q_OBJECT
    // ...
};

class MainWindow : public QMainWindow {
    Q_OBJECT
    QPointer<ToolWindow> m_toolWindow;
    
public:
    void openTool() {
        // 如果窗口还没创建或者已经被用户关掉了（销毁并自动置空了），则重新创建
        if (!m_toolWindow) {
            m_toolWindow = new ToolWindow();
            m_toolWindow->setAttribute(Qt::WA_DeleteOnClose); // 关掉时自动 delete 释放内存
        }
        m_toolWindow->show();
    }
};

[!NOTE]

• 它不是内存管理工具：它不会像 std::shared_ptr 那样管理生命周期，对象的回收依然靠对象树或手动 delete。它只负责在被别人删掉时，及时通知自己变成空。
• 类型限制：只能指向 QObject 派生类，不能用于普通 C++ 类。