做 UE 开发这几年,我养成了一个习惯:遇到诡异的崩溃,先不急着搜答案,而是把相关源码的头文件注释从头读一遍。UE 的源码注释确实写得有体系,尤其是 SharedPointer.h 前面的那一段“智能指针设计大纲”,几乎把整个 TSharedPtr / TSharedRef / TWeakPtr 家族的设计动机和使用规则都讲透了。今天这篇系列笔记(48-2)就顺着 MakeShareable 这个全局函数,以及它背后那个看起来没头没尾的 SharedPointerInternals::TRawPtrProxy<T> 模板类,把 UE 智能指针的内部机制完整盘一遍。
很多新人看 MakeShareable 只记着“把裸指针变成共享指针”,至于它内部经过哪几层构造、为什么返回 TSharedRef 而不用 TSharedPtr、TRawPtrProxy 这个代理类型到底干的什么活,基本没概念。结果代码能跑,但一遇到生命周期问题就抓瞎。这篇文章适合那些已经在 UE5 里写过 C++ 代码、但还没系统读过智能指针源码的开发者。读完你至少能回答三个问题:MakeShareable 的所有权转移意味着什么、TRawPtrProxy 为什么存在、以及 UE 智能指针的注释大纲帮你避开了哪些坑。
1. 为什么会有人盯着 MakeShareable 研究:裸指针失控现场与智能指针家谱
1.1 一个典型的悬挂指针崩溃现场
先还原一个我调试过多日的场景。项目里有个资源管理模块,内部维护一张资源表。某个业务逻辑从资源管理模块拿到一个裸指针,缓存起来,等待异步回调时再访问:
cpp复制UObject* CachedResource = ResourceManager->GetResource(TEXT("Enemy_CH0601"));
AsyncTask(ENamedThreads::AnyBackgroundThreadNormalTask, [CachedResource]()
{
// 这里访问 CachedResource
CachedResource->SomeFunction();
});
如果资源管理模块在后台某个时刻把资源释放了,回调里访问的就是悬挂指针。这种崩溃随机性极强:Debug 配置下可能表现在访问已释放内存,Release 配置下可能直接读出脏数据,偶尔还会触发内存保护异常。更麻烦的是,崩溃堆栈往往指向业务代码而不是释放代码,查起来相当费劲。
我当时加了一堆判空 if (CachedResource),完全没用——悬挂指针本身非空,只是指向的对象已经没了。真正有效的做法是把裸指针换成共享所有权智能指针,让生命周期跟着引用计数走。这也是 MakeShareable 被设计出来的典型场景:你从外部拿到一个裸指针,需要把它接入共享所有权体系。
1.2 UE 智能指针家谱一览
UE 的智能指针家族一共五个主要成员,整整齐齐放在 SharedPointer.h 里,它们共享一套引用计数基础设施。我用表格梳理一下:
| 类型 | 所有权 | 可否为空 | 判空方式 | 典型用途 |
|---|---|---|---|---|
TSharedPtr |
共享 | 可空 | IsValid() |
生命周期不定的对象引用 |
TSharedRef |
共享 | 不可空 | 无需判空 | 非空契约,管理器持有的引用 |
TWeakPtr |
弱引用 | 可空 | Pin() |
打破循环引用,观察外部对象 |
TUniquePtr |
独占 | 可空 | 原生判空 | 独占所有权的动态对象 |
TSharedFromThis |
共享 | - | - | 对象内部获取指向自身的共享指针 |
每个类型都有应用场景,不是随便选。TSharedRef 传递“这个对象一定存在”的契约,函数参数如果用 TSharedRef 接收,调用方在编译阶段就必须保证给个有效引用,这比运行时判空更早暴露问题。TWeakPtr 则用于那些“我可能要观察你,但我不想替你续命”的场景。等你读 SharedPointer.h 的注释大纲时会发现,官方对每个类型的使用边界写得很清楚,根本不用自己瞎猜。
1.3 MakeShareable 在这个家谱里的位置
MakeShareable 不是类,是定义在 SharedPointer.h 里的全局模板函数,专门负责“从裸指针创建 TSharedRef”。它不分配对象内存,也不拷贝对象,而是通过内部机制把裸指针的所有权转移给引用计数控制器。
一定要把它和 MakeShared 区分开:MakeShared 是从无到有创建对象,能一次性分配对象和控制块,性能更好;MakeShareable 是接管一个已经存在的裸指针,用于第三方接口、反射系统、旧模块回调等场景。理解这个差异,是后续正确使用的前提。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
