大家好，我是讯享网，很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。



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

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

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

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

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

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

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

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

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

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

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

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

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

 随堂测验：口述回答
用自己的话说说：Qt 的对象树机制解决了什么问题？为什么比手动 delete 更安全？

(请先自己想一下，再往下滑看答案)

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

答案参考：

• 解决了对象所有权不明确的问题，父对象拥有子对象
• 自动清理避免了忘记 delete 导致的内存泄漏
• 异常安全，即使中间代码抛异常，对象树仍然会正确清理
  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  
  

2.1 栈对象的自动管理

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

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

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

2.2 对象树的限制

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

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

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

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

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

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

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

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

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

3.1 QScopedPointer——独占所有权

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

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

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

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

⚠️ 坑 #2：QScopedPointer 不能复制
❌ 错误做法：

QScopedPointer<QWidget> ptr1(new QWidget()); QScopedPointer<QWidget> ptr2 = ptr1; // 编译错误！不能复制 

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

3.2 QSharedPointer——共享所有权

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

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

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

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

// 自定义删除器 auto customDeleter = [](QWidget* obj) ; QSharedPointer<QWidget> ptr(new QWidget(), customDeleter); 

3.3 QWeakPointer——弱引用

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

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

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

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

 随堂测验：代码填空
补全以下代码，使用 QWeakPointer 安全地访问可能已删除的对象：

QSharedPointer<QLabel> labelPtr(new QLabel("Hello")); QWeakPointer<QLabel> weakLabel = ______; // 一段时间后... if (!weakLabel.______)  } 

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

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

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

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

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

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

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

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

// 推荐用对象树 QWidget window; QPushButton* button = new QPushButton(“Click”, &window); 

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

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

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

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

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

// 推荐用 QPointer QPointer<QLabel> label = findLabel(); // 需要使用时先检查 if (label)  

🎯 练习项目：任务管理器

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

✅ 完成标准：

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

💡 提示：

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

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

---

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

---

1. 现代Qt开发教程（新手篇）1.1——QObject 与元对象系统 - 相似度 100%
2. 现代Qt开发教程（新手篇）1.2——信号与槽 - 相似度 100%
3. 通用GUI编程技术——图形渲染实战（二十八）——图像格式与编解码：PNG/JPEG全掌握 - 相似度 100%