现代Qt开发教程（新手篇）1.6——内存管理-酒店常州论坛

现代Qt开发教程（新手篇）1.6——内存管理

相关仓库仍然已经开源，正在积极火热的建设之中，欢迎各位大佬提Issue和PR！

链接地址：https://github.com/Awesome-Embedded-Learning-Studio/Tutorial_AwesomeQt

1. 前言：C++ 内存管理的痛

说实话，C++ 的内存管理是最让新手头疼，也最让老手翻车的部分。我自己刚学 Qt 的时候，没少在new和delete上栽跟头。要么忘了delete导致内存泄漏，要么同一个对象被delete了两次直接程序崩溃。

更绝的是，Qt 这套框架自己就有对象树机制，而 C++11 之后又有了std::unique_ptr、std::shared_ptr，然后 Qt 自己又搞了一套QSharedPointer、QScopedPointer。这堆东西混在一起，新手很容易迷失方向。

所以这一篇，我们要把这些东西捋清楚。不是让你死记硬背 API，而是理解每种方案背后的设计理念和使用场景。学会之后，你会发现 Qt 的内存管理其实比纯 C++ 要轻松很多。

2. 对象树自动清理——Qt 的第一道防线

Qt 最经典的内存管理机制就是对象树。简单来说，当你创建一个QObject派生类对象时，可以给它指定一个父对象。这个父对象就拥有了这个子对象的所有权，当父对象被销毁时，所有子对象会被自动销毁。

这听起来很抽象，我们来看个具体的例子。假设你在做一个窗口程序，里面有一个按钮、一个标签、一个输入框。在传统 C++ 里，你需要手动管理这些控件的生命周期：

// 传统 C++ 风格，容易出错QWidget*window=newQWidget();QPushButton*button=newQPushButton(window);QLabel*label=newQLabel(window);QLineEdit*edit=newQLineEdit(window);// 用完之后必须手动 delete，顺序还不能乱deleteedit;deletelabel;deletebutton;deletewindow;// 一旦中间抛异常，内存泄漏妥妥的

而在 Qt 里，只要在构造时指定父对象，就万事大吉了：

// Qt 风格，自动管理QWidget*window=newQWidget();// 这里传入 window 作为父对象，这些控件就加入了 window 的对象树QPushButton*button=newQPushButton("Click me",window);QLabel*label=newQLabel("Hello",window);QLineEdit*edit=newQLineEdit(window);// 只需要 delete 窗口，所有子控件会自动被清理deletewindow;// button、label、edit 都会自动 delete

这个机制的核心在于QObject的构造函数：

QObject::QObject(QObject*parent=nullptr);

当你传入一个非空的parent时，这个对象就会被添加到父对象的children()列表里。当父对象析构时，它会遍历所有子对象并逐个删除。

📝随堂测验：口述回答
用自己的话说说：Qt 的对象树机制解决了什么问题？为什么比手动delete更安全？
(请先自己想一下，再往下滑看答案)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
答案参考：
解决了对象所有权不明确的问题，父对象拥有子对象
自动清理避免了忘记delete导致的内存泄漏
异常安全，即使中间代码抛异常，对象树仍然会正确清理
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

2.1 栈对象的自动管理

其实更推荐的做法是直接在栈上创建父对象：

// 更好的做法，栈对象自动析构QWidget window;QPushButtonbutton("Click me",&window);QLabellabel("Hello",&window);// window 超出作用域自动析构，button 和 label 也会自动清理// 不需要任何 delete，完美

这种写法结合了 C++ 的 RAII（资源获取即初始化）和 Qt 的对象树，是最安全的做法。栈对象在离开作用域时会自动调用析构函数，触发对象树的清理机制。

2.2 对象树的限制

对象树机制虽好，但不是万能的。它有几个明显的限制：

第一，只能用于QObject及其派生类。如果你用的是标准 C++ 类或者第三方库的类，这套机制就用不上。

第二，子对象的生命周期完全绑定在父对象上。你不能单独删除一个子对象然后继续使用它，也不能在父对象删除后继续访问子对象。

第三，对象树不适合共享所有权的场景。如果一个对象可能被多个地方同时引用，对象树就无法表示这种关系。

⚠️坑 #1：重复删除导致崩溃
❌ 错误做法：

QWidget*window=newQWidget();QPushButton*button=newQPushButton("Click",window);deletebutton;// 手动删除子对象deletewindow;// window 析构时会再次删除 button，崩溃！

> ✅ 正确做法： > ```cpp > QWidget* window = new QWidget(); > QPushButton* button = new QPushButton("Click", window); > delete window; // 只删除父对象，子对象自动清理 >

💥 后果：双重free导致程序崩溃，或者内存损坏
💡 一句话记住：子对象交给对象树后，就别再手动delete

3. 智能指针——Qt 的第二道防线

当对象树不够用时，Qt 提供了一套智能指针来帮助管理内存。这套智能指针在 C++11 之前就存在了，比标准库的智能指针出现得更早。

3.1 QScopedPointer——独占所有权

QScopedPointer是最简单的智能指针，它表示对某个对象的独占所有权。当QScopedPointer超出作用域时，它所指向的对象会被自动删除。你不能复制它，只能移动它（C++11 之后）。

这个类在 Qt 5.15 之后被标记为已废弃，推荐使用 C++11 的std::unique_ptr。但既然是教程，我们还是了解一下，毕竟可能会在老代码里见到。

QScopedPointer<QWidget>window(newQWidget());// 使用 window.get() 获取原始指针// 或者用 window-> 直接访问成员（重载了 -> 和 *）window->show();// window 超出作用域时，自动 delete

QScopedPointer的使用场景很明确：当你需要一个对象，且这个对象的所有权不会被转移时，用它就很合适。

⚠️坑 #2：QScopedPointer 不能复制
❌ 错误做法：
QScopedPointer<QWidget>ptr1(newQWidget());QScopedPointer<QWidget>ptr2=ptr1;// 编译错误！不能复制

> ✅ 正确做法： > ```cpp > QScopedPointer<QWidget> ptr1(new QWidget()); > // 如果需要转移所有权，使用 reset() > QScopedPointer<QWidget> ptr2; > ptr2.reset(ptr1.take()); // take() 释放所有权但不删除对象 >

💥 后果：代码无法编译，设计上就防止了所有权的混乱
💡 一句话记住：QScopedPointer是排他性的，一个对象只能被一个QScopedPointer拥有

3.2 QSharedPointer——共享所有权

QScopedPointer的局限在于它不支持共享所有权，而QSharedPointer正好解决了这个问题。它使用引用计数来追踪有多少个QSharedPointer指向同一个对象，当引用计数归零时，对象被删除。

// 创建一个共享指针QSharedPointer<QWidget>ptr1(newQWidget());// 复制共享指针，引用计数增加到 2QSharedPointer<QWidget>ptr2=ptr1;// 现在有两个指针指向同一个对象// 无论哪个先离开作用域，对象都不会被删除// 只有当两者都离开作用域，引用计数归零，对象才被删除

这个机制在处理不确定生命周期的对象时非常有用。比如你可能有一个全局的资源管理器，多个组件都需要访问同一个配置对象，但又没人真正"拥有"这个对象。这时候用QSharedPointer就很合适。

QSharedPointer还支持自定义删除器，可以在删除对象时执行额外的操作：

// 自定义删除器autocustomDeleter=[](QWidget*obj){qDebug()<<"About to delete widget";deleteobj;};QSharedPointer<QWidget>ptr(newQWidget(),customDeleter);

3.3 QWeakPointer——弱引用

QWeakPointer是QSharedPointer的伴生类，它持有对某个对象的弱引用，不会增加引用计数。这听起来很奇怪，为什么需要这样一个东西？

想象一个场景：两个对象互相持有对方的QSharedPointer。A 对象有 B 的共享指针，B 对象也有 A 的共享指针。这样它们的引用计数永远不会归零，永远不会被删除，这就是典型的循环引用问题。

QWeakPointer的作用就是打破这种循环。它指向一个由QSharedPointer管理的对象，但不参与引用计数。当原对象被删除后，QWeakPointer会自动变为空：

QSharedPointer<QWidget>strongPtr(newQWidget());QWeakPointer<QWidget>weakPtr=strongPtr;// weakPtr 不会影响 strongPtr 的引用计数if(!weakPtr.isNull()){// 安全地使用对象QSharedPointer<QWidget>locked=weakPtr.toStrongRef();if(locked){locked->show();}}// 当 strongPtr 离开作用域，对象被删除// weakPtr 会自动变为空，再调用 isNull() 会返回 true

🔲随堂测验：代码填空
补全以下代码，使用QWeakPointer安全地访问可能已删除的对象：
QSharedPointer<QLabel>labelPtr(newQLabel("Hello"));QWeakPointer<QLabel>weakLabel=______;// 一段时间后...if(!weakLabel.______){QSharedPointer<QLabel>strong=weakLabel.______();if(______){strong->show();}}

> > *(提示：labelPtr、isNull、toStrongRef、strong)* > > ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ > > **答案参考**： > ```cpp > QSharedPointer<QLabel> labelPtr(new QLabel("Hello")); > QWeakPointer<QLabel> weakLabel = labelPtr; > > // 一段时间后... > if (!weakLabel.isNull()) { > QSharedPointer<QLabel> strong = weakLabel.toStrongRef(); > if (strong) { > strong->show(); > } > } >

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

3.4 QPointer——弱引用的另一种选择

QPointer是专门为QObject设计的弱指针。它比QWeakPointer更早出现，用法也更简单：

QPointer<QLabel>label=newQLabel("Hello");// label 不持有强引用，不影响对象生命周期// 检查对象是否还存在if(label){label->show();}// 如果 label 指向的对象被删除，label 会自动变为空

QPointer的优势是专门为QObject优化，当对象被删除时能立即感知。但它只能用于QObject及其派生类，而QWeakPointer更通用。

4. 何时用什么——实战指南

讲了这么多，我们来总结一下不同场景下的最佳实践：

场景一：UI 控件的父子关系

// 推荐用对象树QWidget window;QPushButton*button=newQPushButton("Click",&window);

场景二：短暂使用的临时对象

// 推荐用栈对象或 std::unique_ptrstd::unique_ptr<QWidget>window(newQWidget());// 或者直接QWidget window;

场景三：需要在多个地方共享的对象

// 推荐用 QSharedPointerQSharedPointer<Config>config(newConfig());// 多个模块都持有这个 config 的副本

场景四：观察某个可能被删除的 QObject

// 推荐用 QPointerQPointer<QLabel>label=findLabel();// 需要使用时先检查if(label){label->setText("Updated");}

5. 练习项目

🎯练习项目：任务管理器

📋功能描述：
创建一个简单的任务管理器程序，每个任务有一个名称、优先级和状态。主界面显示所有任务，用户可以添加、删除、完成任务。

✅完成标准：

使用对象树管理 UI 控件的生命周期
使用QSharedPointer管理任务对象的共享所有权
使用QPointer安全地持有对可能被删除的任务项的引用
程序退出时无内存泄漏（可以用 Valgrind 或 Qt Creator 的内置工具检测）
删除任务后，所有对该任务的引用都能正确处理

💡提示：

定义一个Task类，存储任务信息
用QSharedPointer<Task>在主窗口和任务详情窗口之间共享任务数据
用QPointer<QListWidgetItem>安全地持有列表项的引用
记得在析构函数中打印调试信息，验证对象被正确删除

6. 官方文档参考

📎 Object Trees & Ownership | Qt Core 6.10.2 · Qt 对象树与所有权机制的官方文档
📎 QSharedPointer Class | Qt Core 6.10.2 · QSharedPointer 完整参考
📎 QWeakPointer Class | Qt Core 6.10.2 · QWeakPointer 完整参考
📎 QScopedPointer Class | Qt Core 6.10.2 · QScopedPointer 完整参考

（链接已验证，2026-03-17 可访问）

到这里，Qt 的内存管理基础就讲完了。掌握了对象树和智能指针，你的 Qt 程序就已经能够避免大部分内存相关的 bug。下一节我们会深入 Qt 的事件系统，这是理解 Qt 程序运行机制的关键。

企业官网建设流程全解析