FName的概念:在虚幻引擎中FName是一种专为高性能标识场景设计的轻量级、不可变、基于全局字符串池的哈希优化字符串类型是引擎核心基础数据类型之一用于高效存储和匹配 “标识性字符串”而非动态文本。一、FName 的核心特性全局字符串池String Pool机制FName 不会直接存储字符串内容而是将唯一字符串存入引擎的全局哈希池FNamePool每个字符串对应一个FNameEntry含字符串内容 哈希值FName 实例仅存储指向该条目的索引 编号uint32。相同字符串的 FName 复用同一池条目避免内存冗余如多次创建FName(Enemy)仅存一份字符串引擎启动时预加载常用字符串如资源路径、内置名称进一步提升效率。不可变性FName 创建后内容无法修改若需变更只能新建实例 —— 保证哈希值稳定避免查找 / 匹配失效。默认大小写不敏感例如FName(Enemy)和FName(enemy)会被视为同一 FName可通过项目设置开启大小写敏感但不推荐简化标签、名称的匹配逻辑。高效比较与查找FName 的比较直接对比池索引O (1) 时间复杂度远快于普通字符串的逐字符比较O (n)适合作为键值或标识。二、FName 的典型用途对象标识Actor、Component、UObject 的实例名称如Actor-GetFName()标签系统Actor/Component 的Tags属性TArrayFName、GameplayTag 的名称部分资源路径蓝图、纹理、音效等资源的路径标识如FName(/Game/Blueprints/BP_Player)反射与元数据标识 UProperty、UFunction 的名称如GetPropertyByName(FName(Health))高效键值TMapFName, UObject*等容器的键类型利用快速比较特性。三、FName 与其他字符串类型的区别虚幻引擎中三种核心字符串类型的定位差异类型核心特点适用场景FName不可变、池化、哈希优化、大小写不敏感标识、键值、快速比较 / 查找FString可变、支持复杂文本操作拼接 / 格式化动态文本处理玩家输入、日志FText本地化支持、多语言适配UI 文本、玩家可见的本地化内容// 创建从字符串字面量/ FString 转换 FName EnemyTag FName(TEXT(Enemy)); FString Str TEXT(Player); FName PlayerTag FName(*Str); // 比较O(1) 效率 bool bEqual (EnemyTag FName(TEXT(enemy))); // true默认大小写不敏感 // 转换FName → FString/FText FString TagStr EnemyTag.ToString(); FText TagText FText::FromName(EnemyTag); // 有效性检查 bool bValid !EnemyTag.IsNone(); // 空 FName 为 NAME_None四、如何将普通字符串传入 / 转换为 FNameFName 支持从多种普通字符串类型转换核心是通过构造函数或显式转换以下是常见场景1. 从 C 原生字符串const char*/ 字面量转换直接通过 FName 构造函数建议用TEXT()宏兼容 Unicode虚幻引擎默认使用宽字符// 直接传入字符串字面量推荐用TEXT宏 FName TagName FName(TEXT(Enemy)); // 从const char*变量转换 const char* Str Player; FName PlayerName FName(Str); // 或 FName(TEXT(Str))需确保Str是宽字符2. 从std::string转换需先将std::string转为const char*解引用再传入 FName 构造函数std::string StdStr Interactable; FName InteractTag FName(TCHAR_TO_ANSI(*StdStr.c_str())); // 或直接 FName(StdStr.c_str())3. 从虚幻 FString 转换FString 是虚幻的可变字符串类型转换时需解引用 FString*FString获取TCHAR*FString FStr TEXT(Frozen); FName FrozenTag FName(*FStr); // 核心用*解引用FString为TCHAR*4. 函数参数中直接传入普通字符串若函数参数要求 FName如ActorHasTag(FName)可直接传字符串字面量隐式转换// 直接传字符串字面量引擎自动隐式转为FName bool bIsEnemy MyActor-ActorHasTag(TEXT(Enemy));五、注意事项大小写问题FName 默认不区分大小写若需严格区分需在项目设置中开启 “Case Sensitive FNames”不推荐可能破坏引擎逻辑性能开销转换普通字符串到 FName 时引擎会检查字符串池若不存在则添加频繁转换动态文本如玩家输入会导致字符串池膨胀需避免空值处理空字符串会转为 FName 的NAME_None空 FName可通过IsNone()检查FName EmptyName FName(TEXT()); bool bIsNone EmptyName.IsNone(); // 返回trueMyTag是什么类型?在 C 标准语法和虚幻引擎的编译环境中MyTag的类型需分场景讨论核心差异源于字符编码配置和引擎的类型定义一、标准 C 中的类型在原生 C 中双引号包裹的字符串字面量如MyTag的默认类型是const char*指向窄字符数组的常量指针窄字符char通常占 1 字节对应 ASCII 编码。如果是带L前缀的字符串如LMyTag则类型为const wchar_t*指向宽字符数组的常量指针宽字符wchar_t占 2 或 4 字节对应 Unicode 编码。二、虚幻引擎环境中的类型虚幻引擎默认启用UNICODE宏可在项目设置中确认并通过TCHAR统一字符类型TCHAR是虚幻定义的通用字符类型在 Windows 平台等价于wchar_t宽字符其他平台可能等价于char窄字符若直接写MyTag在虚幻的编译环境中它仍会被识别为const char*但虚幻的核心 API如 FName 构造函数支持从const char*隐式转换为TCHAR*或直接兼容若用TEXT(MyTag)包裹推荐写法则会根据UNICODE宏自动适配启用UNICODE时TEXT(MyTag)→LMyTag→ 类型为const TCHAR*即const wchar_t*未启用UNICODE时TEXT(MyTag)→MyTag→ 类型为const TCHAR*即const char*。三、为什么虚幻中传入MyTag不会报错虽然MyTag本身是const char*但 FName 类提供了兼容const char*的构造函数或引擎内部做了隐式转换同时GetAllActorsWithTag的第二个参数要求的FName支持从const char*/const TCHAR*隐式创建因此编译器会自动完成类型转换不会报错。TEXT()是什么?在虚幻引擎以及 Windows API、C 跨平台开发场景中TEXT()是一个用于统一字符编码的宏核心作用是让字符串字面量根据编译环境自动适配窄字符ANSI/char或宽字符Unicode/WCHAR最终转换为虚幻引擎的通用字符类型TCHAR。一、TEXT()的本质与作用1. 解决字符编码兼容性问题C 中有两种常见字符类型窄字符char占 1 字节通常对应 ASCII 编码仅支持英文字符宽字符WCHAR/wchar_t占 2 字节Windows或 4 字节Linux支持 Unicode 编码可存储中文、日文等多语言字符。虚幻引擎定义了 **TCHAR** 作为 “通用字符类型”在 Windows 平台默认等价于WCHARUnicode其他平台可根据配置调整。TEXT()宏的作用就是将普通字符串字面量如Enemy包装为TCHAR类型的字面量避免编码不匹配导致的编译错误或乱码。2. 宏的底层定义在虚幻引擎的源码中TEXT()宏的定义简化为#ifdef UNICODE #define TEXT(str) L##str // 宽字符模式拼接L前缀如TEXT(Enemy) → LEnemy #else #define TEXT(str) str // 窄字符模式直接使用原字符串如TEXT(Enemy) → Enemy #endifL##str是 C 的 “宏拼接” 语法给字符串加L前缀表示宽字符字面量虚幻引擎默认启用UNICODE宏因此TEXT(XXX)最终会被解析为宽字符字面量LXXX。二、TEXT()的使用场景1. 适配虚幻引擎的TCHAR类型虚幻引擎的核心字符串类型如FName、FString、FText均基于TCHAR实现因此定义字符串字面量时必须用TEXT()否则会出现 “char*无法转换为TCHAR*” 的编译错误。例如// 正确TEXT()将字符串转为TCHAR类型匹配FName的构造函数 FName TagName FName(TEXT(Enemy)); // 错误直接传入char*类型与TCHAR*不兼容虚幻默认Unicode模式下 // FName WrongName FName(Enemy);2. 跨平台 / 多语言兼容使用TEXT()后字符串会自动适配目标平台的字符编码无需手动区分 “宽字符 / 窄字符”尤其适合需要支持中文、日文等多语言的项目。三、与TEXT()相关的常见宏为了处理不同字符类型的转换虚幻引擎还提供了辅助宏TCHAR_TO_ANSI将TCHAR*转为char*窄字符ANSI_TO_TCHAR将char*转为TCHAR*宽字符TCHAR_TO_UTF8将TCHAR*转为 UTF-8 编码的字符串。FString FStr TEXT(测试); // 将TCHAR类型的FString转为UTF-8字符串 const UTF8CHAR* Utf8Str TCHAR_TO_UTF8(*FStr);
FName的概念:在虚幻引擎中FName是一种专为高性能标识场景设计的轻量级、不可变、基于全局字符串池的哈希优化字符串类型是引擎核心基础数据类型之一用于高效存储和匹配 “标识性字符串”而非动态文本。一、FName 的核心特性全局字符串池String Pool机制FName 不会直接存储字符串内容而是将唯一字符串存入引擎的全局哈希池FNamePool每个字符串对应一个FNameEntry含字符串内容 哈希值FName 实例仅存储指向该条目的索引 编号uint32。相同字符串的 FName 复用同一池条目避免内存冗余如多次创建FName(Enemy)仅存一份字符串引擎启动时预加载常用字符串如资源路径、内置名称进一步提升效率。不可变性FName 创建后内容无法修改若需变更只能新建实例 —— 保证哈希值稳定避免查找 / 匹配失效。默认大小写不敏感例如FName(Enemy)和FName(enemy)会被视为同一 FName可通过项目设置开启大小写敏感但不推荐简化标签、名称的匹配逻辑。高效比较与查找FName 的比较直接对比池索引O (1) 时间复杂度远快于普通字符串的逐字符比较O (n)适合作为键值或标识。二、FName 的典型用途对象标识Actor、Component、UObject 的实例名称如Actor-GetFName()标签系统Actor/Component 的Tags属性TArrayFName、GameplayTag 的名称部分资源路径蓝图、纹理、音效等资源的路径标识如FName(/Game/Blueprints/BP_Player)反射与元数据标识 UProperty、UFunction 的名称如GetPropertyByName(FName(Health))高效键值TMapFName, UObject*等容器的键类型利用快速比较特性。三、FName 与其他字符串类型的区别虚幻引擎中三种核心字符串类型的定位差异类型核心特点适用场景FName不可变、池化、哈希优化、大小写不敏感标识、键值、快速比较 / 查找FString可变、支持复杂文本操作拼接 / 格式化动态文本处理玩家输入、日志FText本地化支持、多语言适配UI 文本、玩家可见的本地化内容// 创建从字符串字面量/ FString 转换 FName EnemyTag FName(TEXT(Enemy)); FString Str TEXT(Player); FName PlayerTag FName(*Str); // 比较O(1) 效率 bool bEqual (EnemyTag FName(TEXT(enemy))); // true默认大小写不敏感 // 转换FName → FString/FText FString TagStr EnemyTag.ToString(); FText TagText FText::FromName(EnemyTag); // 有效性检查 bool bValid !EnemyTag.IsNone(); // 空 FName 为 NAME_None四、如何将普通字符串传入 / 转换为 FNameFName 支持从多种普通字符串类型转换核心是通过构造函数或显式转换以下是常见场景1. 从 C 原生字符串const char*/ 字面量转换直接通过 FName 构造函数建议用TEXT()宏兼容 Unicode虚幻引擎默认使用宽字符// 直接传入字符串字面量推荐用TEXT宏 FName TagName FName(TEXT(Enemy)); // 从const char*变量转换 const char* Str Player; FName PlayerName FName(Str); // 或 FName(TEXT(Str))需确保Str是宽字符2. 从std::string转换需先将std::string转为const char*解引用再传入 FName 构造函数std::string StdStr Interactable; FName InteractTag FName(TCHAR_TO_ANSI(*StdStr.c_str())); // 或直接 FName(StdStr.c_str())3. 从虚幻 FString 转换FString 是虚幻的可变字符串类型转换时需解引用 FString*FString获取TCHAR*FString FStr TEXT(Frozen); FName FrozenTag FName(*FStr); // 核心用*解引用FString为TCHAR*4. 函数参数中直接传入普通字符串若函数参数要求 FName如ActorHasTag(FName)可直接传字符串字面量隐式转换// 直接传字符串字面量引擎自动隐式转为FName bool bIsEnemy MyActor-ActorHasTag(TEXT(Enemy));五、注意事项大小写问题FName 默认不区分大小写若需严格区分需在项目设置中开启 “Case Sensitive FNames”不推荐可能破坏引擎逻辑性能开销转换普通字符串到 FName 时引擎会检查字符串池若不存在则添加频繁转换动态文本如玩家输入会导致字符串池膨胀需避免空值处理空字符串会转为 FName 的NAME_None空 FName可通过IsNone()检查FName EmptyName FName(TEXT()); bool bIsNone EmptyName.IsNone(); // 返回trueMyTag是什么类型?在 C 标准语法和虚幻引擎的编译环境中MyTag的类型需分场景讨论核心差异源于字符编码配置和引擎的类型定义一、标准 C 中的类型在原生 C 中双引号包裹的字符串字面量如MyTag的默认类型是const char*指向窄字符数组的常量指针窄字符char通常占 1 字节对应 ASCII 编码。如果是带L前缀的字符串如LMyTag则类型为const wchar_t*指向宽字符数组的常量指针宽字符wchar_t占 2 或 4 字节对应 Unicode 编码。二、虚幻引擎环境中的类型虚幻引擎默认启用UNICODE宏可在项目设置中确认并通过TCHAR统一字符类型TCHAR是虚幻定义的通用字符类型在 Windows 平台等价于wchar_t宽字符其他平台可能等价于char窄字符若直接写MyTag在虚幻的编译环境中它仍会被识别为const char*但虚幻的核心 API如 FName 构造函数支持从const char*隐式转换为TCHAR*或直接兼容若用TEXT(MyTag)包裹推荐写法则会根据UNICODE宏自动适配启用UNICODE时TEXT(MyTag)→LMyTag→ 类型为const TCHAR*即const wchar_t*未启用UNICODE时TEXT(MyTag)→MyTag→ 类型为const TCHAR*即const char*。三、为什么虚幻中传入MyTag不会报错虽然MyTag本身是const char*但 FName 类提供了兼容const char*的构造函数或引擎内部做了隐式转换同时GetAllActorsWithTag的第二个参数要求的FName支持从const char*/const TCHAR*隐式创建因此编译器会自动完成类型转换不会报错。TEXT()是什么?在虚幻引擎以及 Windows API、C 跨平台开发场景中TEXT()是一个用于统一字符编码的宏核心作用是让字符串字面量根据编译环境自动适配窄字符ANSI/char或宽字符Unicode/WCHAR最终转换为虚幻引擎的通用字符类型TCHAR。一、TEXT()的本质与作用1. 解决字符编码兼容性问题C 中有两种常见字符类型窄字符char占 1 字节通常对应 ASCII 编码仅支持英文字符宽字符WCHAR/wchar_t占 2 字节Windows或 4 字节Linux支持 Unicode 编码可存储中文、日文等多语言字符。虚幻引擎定义了 **TCHAR** 作为 “通用字符类型”在 Windows 平台默认等价于WCHARUnicode其他平台可根据配置调整。TEXT()宏的作用就是将普通字符串字面量如Enemy包装为TCHAR类型的字面量避免编码不匹配导致的编译错误或乱码。2. 宏的底层定义在虚幻引擎的源码中TEXT()宏的定义简化为#ifdef UNICODE #define TEXT(str) L##str // 宽字符模式拼接L前缀如TEXT(Enemy) → LEnemy #else #define TEXT(str) str // 窄字符模式直接使用原字符串如TEXT(Enemy) → Enemy #endifL##str是 C 的 “宏拼接” 语法给字符串加L前缀表示宽字符字面量虚幻引擎默认启用UNICODE宏因此TEXT(XXX)最终会被解析为宽字符字面量LXXX。二、TEXT()的使用场景1. 适配虚幻引擎的TCHAR类型虚幻引擎的核心字符串类型如FName、FString、FText均基于TCHAR实现因此定义字符串字面量时必须用TEXT()否则会出现 “char*无法转换为TCHAR*” 的编译错误。例如// 正确TEXT()将字符串转为TCHAR类型匹配FName的构造函数 FName TagName FName(TEXT(Enemy)); // 错误直接传入char*类型与TCHAR*不兼容虚幻默认Unicode模式下 // FName WrongName FName(Enemy);2. 跨平台 / 多语言兼容使用TEXT()后字符串会自动适配目标平台的字符编码无需手动区分 “宽字符 / 窄字符”尤其适合需要支持中文、日文等多语言的项目。三、与TEXT()相关的常见宏为了处理不同字符类型的转换虚幻引擎还提供了辅助宏TCHAR_TO_ANSI将TCHAR*转为char*窄字符ANSI_TO_TCHAR将char*转为TCHAR*宽字符TCHAR_TO_UTF8将TCHAR*转为 UTF-8 编码的字符串。FString FStr TEXT(测试); // 将TCHAR类型的FString转为UTF-8字符串 const UTF8CHAR* Utf8Str TCHAR_TO_UTF8(*FStr);
