C++ 中智能指针的使用与最佳实践

在现代 C++ 开发中，智能指针已成为资源管理的核心工具。相比裸指针，智能指针通过 RAII（资源获取即初始化）模式，自动管理对象生命周期，极大降低了内存泄漏、悬空指针等错误。本文将从智能指针的类型、使用场景、常见错误以及优化建议四个方面进行系统阐述，并给出实战代码示例，帮助开发者在日常项目中高效、可靠地使用智能指针。

1. 智能指针概览

1.1 `std::unique_ptr`

所有权单一：每个 unique_ptr 只能拥有一个对象，复制不可行，移动可行。
最小开销：内部仅存一个裸指针，无引用计数开销。
适用场景：局部资源、不可共享对象、单例模式等。

1.2 `std::shared_ptr`

共享所有权：多个 shared_ptr 可以指向同一个对象，引用计数自动管理。
线程安全：引用计数操作采用原子操作，适合多线程共享资源。
适用场景：需要共享所有权、生命周期跨函数、对象存在循环引用风险时需配合 weak_ptr。

1.3 `std::weak_ptr`

非拥有指针：不增加引用计数，用于打破 shared_ptr 形成的循环引用。
安全访问：通过 lock() 转为 shared_ptr，若对象已销毁返回空指针。
适用场景：父子关系、观察者模式、缓存等需要弱引用的情况。

2. 实用技巧与最佳实践

2.1 适配裸指针

不随意转换：除非必要，避免裸指针转 shared_ptr 或 unique_ptr。若必须，使用 std::make_shared 或 std::make_unique。
new 关键字避免：在创建智能指针时尽量使用 make_*，它们能提供异常安全保证并避免两次分配。

auto ptr = std::make_unique <MyClass>(args...);   // 推荐
// 相比
auto ptr = std::unique_ptr <MyClass>(new MyClass(args...)); // 风险

2.2 共享所有权的边界

避免多层共享：若对象仅在单一作用域内使用，尽量使用 unique_ptr，即使在函数间传递也可以使用移动语义。
捕获 shared_ptr：在 lambda 中捕获 shared_ptr 需注意复制引用计数，若 lambda 会被异步执行，使用 std::weak_ptr 捕获后再转为 shared_ptr。

std::weak_ptr <Foo> weakFoo = fooPtr;
auto lambda = [weakFoo]() {
    if (auto sharedFoo = weakFoo.lock()) {
        sharedFoo->doSomething();
    }
};

2.3 循环引用与 `weak_ptr`

经典例子：父子对象互相持有 shared_ptr，导致引用计数永不归零。解决方案是在子对象中使用 weak_ptr 指向父对象，或者在父对象中使用 weak_ptr 指向子对象。

class Parent;
class Child {
    std::weak_ptr <Parent> parent_;
public:
    void setParent(const std::shared_ptr <Parent>& p) { parent_ = p; }
};

class Parent : public std::enable_shared_from_this <Parent> {
    std::shared_ptr <Child> child_;
public:
    void createChild() {
        child_ = std::make_shared <Child>();
        child_->setParent(shared_from_this());
    }
};

2.4 自定义删除器

资源非内存：若需要释放文件句柄、网络连接等非内存资源，可为 unique_ptr 或 shared_ptr 指定自定义删除器。

struct FileCloser {
    void operator()(FILE* fp) const {
        if (fp) fclose(fp);
    }
};

auto file = std::unique_ptr<FILE, FileCloser>(fopen("log.txt", "w"), FileCloser());

2.5 与 STL 容器配合

容器中存储智能指针：推荐使用 unique_ptr（不可复制）或 shared_ptr（可复制）存放在 std::vector、std::list 等。移动语义或复制语义需要根据需求决定。

std::vector<std::unique_ptr<Item>> items;
items.push_back(std::make_unique <Item>(...));

自定义比较函数：若需要按指针内容排序，可通过 [](const auto& a, const auto& b){ return *a < *b; }。

3. 常见错误与调试技巧

错误类型	典型症状	解决方案
悬空指针	解引用已销毁对象	绝不使用裸指针，改用 `shared_ptr` 或 `weak_ptr`
内存泄漏	对象未销毁	确认所有 `unique_ptr` 或 `shared_ptr` 已正确转移或销毁，检查循环引用
拷贝错误	`unique_ptr` 复制失败	仅允许移动语义，必要时使用 `std::move`
多线程竞争	共享对象被多线程并发修改	使用 `std::shared_ptr` + 原子操作，或在需要时使用 `std::mutex` 保护
自定义删除器忘记	资源未释放	为资源提供合适的删除器，或使用 RAII 包装

调试工具

Valgrind：检测内存泄漏、使用后释放错误。
AddressSanitizer：快速捕获悬空指针、越界等错误。
GDB / LLDB：跟踪智能指针生命周期，观察引用计数变化。

4. 进阶主题

4.1 `std::shared_ptr` 的构造细节

内部结构：shared_ptr 由控制块和对象指针两部分组成。控制块中存储引用计数、弱计数、删除器等。
线程安全：引用计数采用 std::atomic，但 weak_ptr 也需要同样的同步。

4.2 性能优化

自定义分配器：在大量小对象时，可为 shared_ptr 配合 std::pmr::polymorphic_allocator 或自定义内存池，减少系统内存分配次数。
避免不必要的共享：在性能敏感的代码路径中优先使用 unique_ptr 或裸指针，只有在真正需要共享时才使用 shared_ptr。

4.3 与 `std::any`、`std::variant` 的结合

类型擦除：使用 std::any 或 std::variant 存储不同类型的智能指针时，需要注意模板特化与删除器兼容性。

using PtrVariant = std::variant<std::unique_ptr<A>, std::unique_ptr<B>>;
PtrVariant v = std::make_unique <A>(...);

5. 结语

智能指针是 C++ 现代化资源管理的基石。掌握其正确使用方式，可以显著提升代码的安全性与可维护性。本文仅提供了核心概念与实践技巧，实际项目中还需结合团队编码规范、性能要求与运行环境进行细化。建议在代码审核时重点检查智能指针的生命周期边界，避免因循环引用或误用导致的内存泄漏。希望本文能为你在 C++ 项目中更好地运用智能指针提供帮助。

1. 智能指针概览

1.1 std::unique_ptr

1.2 std::shared_ptr

1.3 std::weak_ptr