容器与字符串

容器：值语义与内存布局

• TArray 是最常用的容器，「快、省内存、安全」。它是值类型：拥有自己的元素，拷贝时复制全部元素、不共享状态，销毁时元素一并销毁；不应 new/delete 它，也不应继承它。模板参数是元素类型和可选的分配器 (allocator)，默认分配器从堆上分配，并在容量不够时一次多分配几个元素的空间。（Array Containers in Unreal Engine）
• Add 与 Emplace：Add 先构造一个临时对象再拷贝或移动进数组，Emplace 直接用参数在数组里构造。官方经验法则：平凡类型用 Add，其他类型用 Emplace；Emplace 永远不会比 Add 慢。（Array Containers in Unreal Engine）
• TMap / TSet 基于哈希：键类型要提供 GetTypeHash 和 operator==（或自定义 KeyFuncs）。底层是稀疏数组，删除元素会留下空洞，之后新增的元素可能填进空洞，所以遍历顺序不可靠、元素在内存中也不连续。扩容时整块存储会重新分配，所以指向元素的指针可能失效。TMap 遇到重复键时用新值替换旧值；TMultiMap 则两个都保留。TSet 的增删查都是常数时间。（Map Containers in Unreal Engine、Set Containers in Unreal Engine）
• 三者都假定元素是「可平凡搬移 (trivially relocatable)」的，扩容时直接按原始字节拷贝；元素里如果有指向自身内部的指针，这个假设会出问题。

（表格依据上述三页归纳。）

三种字符串

（String Handling in Unreal Engine、FName in Unreal Engine、FText in Unreal Engine、FString in Unreal Engine）

转换的坑（官方原文标为「危险」）：FString → FName 会丢信息，因为 FName 不区分大小写；FText → FString 对某些语言可能丢信息；FText 不能直接转成 FName，要先转 FString。FText::FromString 在编辑器构建中不会把文本标为文化无关 (culture invariant)，保存到资产里的 FText 属性后仍可能变成可本地化文本；真正不需要本地化的文本用 AsCultureInvariant 或 INVTEXT。（FText in Unreal Engine）只想判断某个名字是否已在名称表里、又不想新增条目时，用 FName(TEXT("x"), FNAME_Find)，不存在时得到 NAME_None。（FName in Unreal Engine）

实践建议

• 界面上显示的字符串一律用 FText，否则后期本地化要返工。
• 热路径里避免反复把 FString 构造成 FName（每次都要查哈希表）；常用名字应缓存为静态 FName。
• 容器作为 UPROPERTY 时，GC 才能看到里面的 UObject 引用，见 UObject 与反射系统、垃圾回收与对象生命周期。（与 GC 的关联依据已有页面。）