qt控件未指定父对象或delete致堆内存泄露

一、错误代码示例

会导致内存泄漏的典型场景：

css 复制代码

void ContentWidget::redWarmLayout() {
    // 在堆上创建了 QFormLayout，但没有设置父对象！
    QFormLayout* layout = new QFormLayout(); 
    
    layout->addRow("Name:", new QLineEdit());
    // ... 做了些其他操作，但忘记将 layout 设置给任何 QWidget
} // 函数结束，layout 指针丢失，但这块内存永远不会被释放！

二、现象

如上，在堆上创建了 QFormLayout，但没有设置父对象，函数随着不断被调用，内存泄露会逐渐增加，测试方法很简单，给用定时器每100ms触发一次，几分钟后会看到内存泄露明显扩大。

下图vs内存分析可以看出，由原来20MB内存一路升到160MB，且原因指向了该函数。

三、分析

问题根本原因：错误用法Qt 的自动内存管理机制失效

3.1、脱离了"对象树"的庇护

Qt 解决内存泄漏的核心武器是"父子对象机制"。

当父对象被销毁时，会自动递归删除它的所有子对象。

如果在 new 布局时没有传入父窗口指针，或者没有通过 setLayout() 将其绑定到某个窗口上，这个布局就会成为一个"孤悬"的顶层对象。因为没有任何父节点接管它的所有权，当函数执行结束、局部指针变量离开作用域时，Qt 无法感知到这个对象的消失，自然也不会触发自动回收。

一般有两种方法：

1.`setLayout()`

当你调用 setLayout() 时，Qt 会在底层执行两个关键步骤：

自动重定父级 ：它会通过调用 QObject::setParent()，将传入的 layout 的父对象自动设置为当前的 widget。
绑定管理权 ：将 widget 的布局设置为该 layout，此后该布局负责管理 widget 中所有子控件的排列和位置计算。

因此，在代码中写下 setLayout(formLayout)，等价于让当前窗口（即 this）接管了这块内存的所有权。当窗口销毁时，它会自动清理这个布局，无需手动干预。

2.构造时传入 this

// 推荐写法：直接在构造时传入

this QFormLayout *formLayout = new QFormLayout(this);

直接在构造函数中指定父对象，这样一步就能完成"内存分配"与"绑定"。

如果已经写了 new QFormLayout(this)，就不要再调用 setLayout(formLayout) 了，虽然合法，但属于重复操作。

3.2、堆内存的"只增不减"

使用 new 关键字会在程序的堆区（Heap） 分配内存。与栈上的局部变量不同，堆区的内存不会因为函数的返回而自动释放。

每次你调用这个函数，程序都会向操作系统申请一块新的内存来存放这个布局。由于没有 delete 也没有父对象接管，这些内存块会一直驻留在进程中。随着函数被调用的次数越来越多，未释放的内存块不断累积，最终导致内存泄漏持续增加。

3.3、对于非 GUI 组件或需要复杂生命周期管理的普通 C++ 数据对象

可以使用QScopedPointer

cpp 复制代码

class Data {
public:
    Data() { qDebug() << "Data created"; }
    ~Data() { qDebug() << "Data destroyed"; }
};

void func() {
    Data* d = new Data();

    if (someCondition()) {
        return;  // 忘记 delete → 内存泄漏
    }

    delete d;
}

👉 一旦提前 return，就会泄漏。

QScopedPointer：最简单的 RAII 管理

适用于：单一所有者、局部对象