如果你用 UE5 写过一阵子 C++,大概率已经见过 MakeShareable 了,尤其是处理从 C 风格接口、第三方原生库或者旧模块手里接过来的裸指针时。绝大多数教程只会告诉你“用 MakeShareable 把裸指针包成 TSharedPtr”,但当你真去翻引擎头文件里的源码注释,会发现它真正的返回类型其实是 SharedPointerInternals::TRawPtrProxy<T>,一个很多开发者听都没听过的类型。
这篇笔记就顺着引擎源码注释的线索走一遍:MakeShareable 返回的 TRawPtrProxy<T> 到底是什么、TSharedPtr 和 TSharedRef 的构造函数为什么要去消费这个临时代理、引用控制器是在哪一步创建的、以及实践里最容易踩的几个坑。我把它写成一份“源码注释大纲式”的拆解,适合那些已经会基本用 TSharedPtr,但还想把智能指针底层机制彻底搞明白的人。
1. MakeShareable 到底解决什么问题
1.1 从“接管裸指针”说起
在 UE5 的 C++ 环境里,能被 GC 管的是 UObject,而绝大多数普通 C++ 对象只能用 new 创建。这类对象一旦指针被传来传去,很容易出现两件事:要么没人 delete 导致泄漏,要么两个模块同时 delete 导致崩溃。TSharedPtr 就是来解决这个问题的,它用引用计数保证对象在最后一个持有者放手时才被释放。
但这里有个微妙的地方:TSharedPtr 本身不会凭空知道一个裸指针该不该由它接管。比如你从某个原生库拿回来一个 FNativeHandle*,你到底是只想临时看一眼,还是想把这个指针的生命周期彻底交给智能指针?这必须有一种表达方式。MakeShareable 干的事就是交托所有权,语义非常明确:这个裸指针从现在开始归智能指针管,原来的调用方不要再手动 delete。
cpp复制class FMyData
{
public:
int32 Value = 0;
};
// 场景:某个旧接口返回了裸指针,现在你要接管它
void TakeOverExample()
{
FMyData* RawData = new FMyData();
RawData->Value = 42;
TSharedPtr<FMyData> DataPtr = MakeShareable(RawData);
// 从这行之后,绝对不能再写 delete RawData
}
这种“把所有权决定权显式表达出来”的设计,正是 MakeShareable 存在的理由。它不是一个花哨的工具,而是一道明确区分“观察”和“拥有”的分界线。
1.2 MakeShareable 与 MakeShared 怎么选
很多新手会把 MakeShareable 和 MakeShared 混在一起,以为只是写法不同。实际上它们差距很大,选错会直接影响性能和代码结构。
cpp复制// 方案 A:先有对象,再接管所有权
FMyData* Raw = new FMyData();
TSharedPtr<FMyData> PtrA = MakeShareable(Raw);
// 方案 B:原地创建对象并交给智能指针
TSharedPtr<FMyData> PtrB = MakeShared<FMyData>();
| 对比维度 | MakeShareable(T*) | MakeShared |
|---|---|---|
| 传入方式 | 已有裸指针,所有权移交 | 构造参数原地创建 |
| 内存分配 | 对象一次分配,控制器一次分配,至少两次 | 对象与控制器连续分配,基本一次 |
| 缓存局部性 | 较差,对象和计数不在同一块内存 | 较好 |
| 适用来源 | 第三方库、C 接口、条件构造的对象 | 完全由自己 new 的新对象 |
| 异常/中途失败处理 | 需要调用方保证指针有效 | 构造参数直接转给 T 的构造函数 |
引擎官方推荐优先使用 MakeShared,原因很直接:少一次内存分配,对象和引用计数紧挨着,访问计数时的缓存命中率更高。但实际项目里经常遇到“对象已经存在”的情况,比如模块 A 从 C 库拿到一个裸指针要交给模块 B 托管,这时候只有 MakeShareable 能接住。
1.3 什么场景非用 MakeShareable 不可
我总结了几类必须走 MakeShareable 的典型场景。
第一类是外部库返回值。引擎插件里如果接了原生 C/C++ 库,库内部用 new 创建对象,通过句柄或裸指针返回,这时你想把它纳入智能指针体系,只能通过 MakeShareable。
第二类是条件初始化。某些对象需要先经过复杂的计算、查表或者尝试创建,失败后可能返回另一个备用对象,这种情况下没法用 MakeShared 一次搞
