Puerts项目中的BlueprintPure函数名大小写问题解析

问题背景

在Unreal Engine项目中使用Puerts进行TypeScript开发时，开发者可能会遇到一个特殊问题：当在UBlueprintFunctionLibrary派生类中定义带有BlueprintPure标记的静态函数时，某些特定函数名称（如GetTimestamp）在编辑器模式下运行正常，但在打包后（Windows/Android平台）会出现"TypeError: xxx is not a function"的错误。

问题现象

具体表现为：

1. 定义一个静态BlueprintPure函数：

UFUNCTION(BlueprintCallable, BlueprintPure)
static int64 GetTimestamp();

2. 在TypeScript中调用：

console.log(MyBlueprintFunctionLibrary.GetTimestamp())

3. 编辑器模式下运行正常，但打包后报错

根本原因

这个问题源于Unreal Engine对FName处理在编辑器和运行时的不一致性：

1. FName处理机制：UE在编辑器下对FName大小写敏感，而在运行时大小写不敏感
2. 名称冲突：某些特定函数名（如GetTimestamp）可能被UE内部或其他模块使用，导致运行时名称被修改
3. 大小写转换：在打包后运行时，函数名可能被自动转换为其他形式（如GetTimestamp → GetTimeStamp）

解决方案

1. 避免使用特定函数名：不要使用可能被UE内部使用的常见函数名（如GetTimestamp、GetTime等）
2. 添加前缀：为函数名添加项目特定前缀，如：

UFUNCTION(BlueprintCallable, BlueprintPure)
static int64 MyProject_GetTimestamp();

3. 运行时检查：在TypeScript中添加存在性检查：

if (typeof MyBlueprintFunctionLibrary.GetTimestamp === 'function') {
    console.log(MyBlueprintFunctionLibrary.GetTimestamp())
}

技术细节

1. Puerts绑定机制：Puerts在绑定UE函数时，会使用UE的反射系统获取函数信息
2. FName缓存：UE会缓存FName的第一次使用形式，后续相同名称（不区分大小写）会复用第一次的字符串形式
3. 打包优化：打包过程中UE可能会对某些常用函数名进行优化处理

最佳实践

1. 为项目中的蓝图函数库函数添加项目特定前缀
2. 避免使用过于通用的函数名
3. 在开发阶段同时测试编辑器和打包版本
4. 使用TypeScript的类型声明文件明确函数签名

总结

Puerts与Unreal Engine的深度集成带来了强大的脚本能力，但也需要注意UE内部的一些特殊机制。通过理解FName的处理方式和遵循命名最佳实践，可以避免这类大小写敏感性问题，确保代码在编辑器和打包后都能稳定运行。