UE5字符串与容器：FText、TArray与TMap详解

1. UE5中的字符串类型：Text、Name与FString

在Unreal Engine 5的C++开发中，处理字符串时有三种主要类型：FText、FName和FString。这三种类型各有特点，适用于不同场景。

1.1 FString：动态字符串

FString是UE中最灵活的字符串类型，类似于标准C++中的std::string。它提供了一系列字符串操作功能：

• 动态分配内存，长度可变
• 支持各种字符串操作（拼接、查找、替换等）
• 支持与C风格字符串的转换
• 性能开销相对较大

cpp复制FString MyString = TEXT("Hello");
MyString += TEXT(" Unreal Engine");

提示：在UE5中，所有字符串字面量都应使用TEXT()宏包裹，确保跨平台兼容性。

1.2 FName：不可变标识符

FName是一种轻量级的字符串表示，主要用于存储不可变的名称标识：

• 内部使用哈希表存储，比较操作非常高效
• 不区分大小写（默认情况下）
• 适合用于对象名称、标签等不常修改的标识

cpp复制FName BoneName = TEXT("spine_01");

FName的一个关键特性是"名称表"机制：相同字符串的FName只存储一次，后续创建相同FName时直接引用已有实例。

1.3 FText：本地化文本

FText是专为本地化设计的字符串类型：

• 自动支持多语言
• 提供格式化功能（数字、日期等）
• 不可变，线程安全
• 适合所有需要显示给用户的文本

cpp复制FText Greeting = NSLOCTEXT("MyNamespace", "Hello", "你好");

在实际项目中，我建议遵循以下原则：

• 用户界面显示：总是使用FText
• 对象标识和标签：优先使用FName
• 需要频繁操作的字符串：使用FString

2. TArray：UE5中的动态数组

TArray是UE5中最常用的容器类，功能类似于C++标准库中的std::vector，但提供了更多游戏开发专用的功能。

2.1 基本操作

cpp复制TArray<int32> Numbers;
Numbers.Add(10);  // 添加元素
Numbers.Emplace(20); // 原地构造
Numbers.Insert(15, 1); // 在索引1处插入

int32 Count = Numbers.Num(); // 获取元素数量
bool bEmpty = Numbers.IsEmpty(); // 检查是否为空

2.2 元素访问

TArray提供了多种安全的元素访问方式：

cpp复制// 常规访问
int32 First = Numbers[0];

// 安全访问（检查边界）
int32 SafeFirst = Numbers.IsValidIndex(0) ? Numbers[0] : -1;

// 首尾元素访问
int32 FirstElement = Numbers.First();
int32 LastElement = Numbers.Last();

注意：直接使用[]操作符访问时不会进行边界检查，在发布版本中这会带来性能优势，但在调试版本中会触发断言。

2.3 元素删除

TArray提供了多种删除元素的方式：

cpp复制// 删除指定索引处的元素
Numbers.RemoveAt(1);

// 删除所有值为10的元素
Numbers.Remove(10);

// 删除所有满足条件的元素
Numbers.RemoveAll([](int32 Val) { return Val > 15; });

// 清空数组
Numbers.Empty();

在实际项目中，我发现RemoveAt操作可能会导致数组元素移动，对性能有影响。如果需要频繁删除元素，可以考虑：

1. 使用RemoveAtSwap：将被删除元素与最后一个元素交换，然后删除，避免移动大量元素
2. 标记元素为无效，定期批量清理

3. TMap：键值对容器

TMap是UE5中的关联容器，类似于C++的std::unordered_map，但针对游戏开发做了优化。

3.1 基本操作

cpp复制TMap<FString, int32> PlayerScores;
PlayerScores.Add(TEXT("John"), 100);
PlayerScores.Emplace(TEXT("Alice"), 150);

// 访问元素
int32* JohnScore = PlayerScores.Find(TEXT("John"));
if (JohnScore) {
    *JohnScore += 50;
}

// 包含检查
bool bHasAlice = PlayerScores.Contains(TEXT("Alice"));

3.2 迭代器

TMap提供了多种迭代方式：

cpp复制// 常规迭代
for (auto& Pair : PlayerScores) {
    UE_LOG(LogTemp, Log, TEXT("Player %s: %d"), *Pair.Key, Pair.Value);
}

// 使用迭代器对象
for (auto It = PlayerScores.CreateIterator(); It; ++It) {
    if (It->Value < 100) {
        It.RemoveCurrent(); // 可以在迭代时删除
    }
}

3.3 TPair与继承链

TMap中的元素实际上是TPair<K,V>类型，这是一个简单的结构体：

cpp复制template<typename KeyType, typename ValueType>
struct TPair {
    KeyType Key;
    ValueType Value;
};

在UE5中，TPair的继承链相对简单，主要是为了支持各种容器操作而设计。理解这一点对于实现自定义容器或扩展TMap功能很有帮助。

4. 性能优化与最佳实践

4.1 容器预分配

对于已知大小的容器，预先分配内存可以避免频繁重新分配：

cpp复制TArray<FVector> Positions;
Positions.Reserve(1000); // 预分配1000个元素的空间

4.2 选择合适的容器

• 需要快速查找：使用TMap或TSet
• 需要保持顺序：使用TArray
• 需要唯一元素：使用TSet

4.3 避免频繁的内存分配

在游戏循环中频繁创建和销毁容器会导致性能问题。可以考虑：

1. 重用容器对象
2. 使用对象池
3. 在适当的时候使用Move语义

cpp复制TArray<FString> GetPlayerNames() {
    TArray<FString> Names;
    // ...填充数据
    return MoveTemp(Names); // 使用移动语义避免拷贝
}

5. 常见问题与解决方案

5.1 TArray越界访问

问题现象：游戏崩溃，特别是发布版本中难以追踪

解决方案：

• 在调试版本中使用[]操作符（会触发断言）
• 在发布版本中使用IsValidIndex检查
• 或者使用GetData()和Num()组合进行安全访问

5.2 TMap查找性能下降

问题现象：随着元素增加，查找速度变慢

解决方案：

• 检查键类型的哈希函数是否高效
• 考虑使用更简单的键类型
• 对于固定大小的映射，可以改用排序的TArray+二分查找

5.3 内存碎片化

问题现象：长时间运行后内存使用效率下降

解决方案：

• 定期整理容器（如使用Compact等函数）
• 使用自定义分配器
• 避免频繁的小块内存分配

6. 实际应用案例

6.1 游戏存档系统

使用TMap存储玩家进度：

cpp复制TMap<FName, FPlayerLevelData> SaveData;

// 保存数据
SaveData.Add(TEXT("Level1"), Level1Data);
SaveData.Add(TEXT("Level2"), Level2Data);

// 加载数据
if (auto* Data = SaveData.Find(TEXT("Level1"))) {
    ApplyLevelData(*Data);
}

6.2 AI行为树黑板

使用TArray存储AI任务队列：

cpp复制TArray<FAITask> PendingTasks;

// 添加任务
PendingTasks.Emplace(FAITask::Type::MoveTo, TargetLocation);

// 处理任务
while (!PendingTasks.IsEmpty()) {
    FAITask CurrentTask = PendingTasks.Pop();
    ExecuteTask(CurrentTask);
}

6.3 UI本地化系统

使用FText实现多语言UI：

cpp复制TMap<FName, FText> LocalizedTexts;

// 加载本地化文本
LocalizedTexts.Add(TEXT("WelcomeMessage"), 
    NSLOCTEXT("GameUI", "Welcome", "Welcome to the game!"));

// 显示文本
void UMyWidget::UpdateUI() {
    if (auto* Text = LocalizedTexts.Find(TEXT("WelcomeMessage"))) {
        WelcomeText->SetText(*Text);
    }
}

在UE5项目开发中，合理使用这些容器和字符串类型可以显著提高代码效率和可维护性。根据我的经验，遵循以下原则可以避免许多常见问题：

1. 明确每种类型的适用场景
2. 注意内存管理和性能影响
3. 在适当的时候使用UE提供的工具函数
4. 保持代码风格一致，便于团队协作

最后分享一个实用技巧：在开发过程中，可以使用UE_LOG输出容器内容进行调试，但记得在发布版本中移除这些日志语句以提高性能。