Puerts项目中的UE静态函数大小写问题解析与解决方案

问题背景

在Unreal Engine游戏开发中，Puerts作为连接TypeScript/JavaScript与UE引擎的桥梁，为开发者提供了强大的脚本化能力。然而，在UE5.4.4版本中使用Puerts 1.0.5时，开发者可能会遇到一个棘手的问题：在编辑器模式下运行正常的静态函数调用，在打包后却出现函数为空的错误。

问题现象

具体表现为，某些静态方法（如UKismetMathLibrary::Atan）在打包后，其方法名称的大小写发生了变化（变为atan），导致调用失败。通过遍历输出库中的所有方法可以发现，部分方法名称在打包后被自动转换为小写形式。

根本原因分析

这个问题源于UE引擎中FName的处理机制：

1. FName特性：UE的FName系统默认不区分大小写，且FName转字符串的结果取决于它第一次构造时使用的字符串形式
2. V8引擎差异：在打包后，V8引擎对成员函数和属性的处理能够自动规避FName的大小写问题，但对静态函数和变量的支持尚未完善
3. 名称转换：当请求Atan方法时，系统会先转换成FName，然后再转换回字符串，导致原始的大小写信息丢失

解决方案

临时解决方案：使用Proxy代理

可以通过修改Puerts的JavaScript加载逻辑，为类添加一个Proxy层来处理大小写问题：

function getFName(str) {
    // 实际实现应从UE获取FName转换后的字符串
    return 'clamp'; // 示例值
}

function FNameCaseFix(cls) {
    let proxy = new Proxy(cls, {
        get: function(cls, name) {
            let m = cls[getFName(name)]; 
            Object.defineProperty(cls, name, {
                value: m,
                writable: false,
                configurable: true,
                enumerable: false,
            });
            return m;
        }
    });
    Object.setPrototypeOf(cls, proxy);
    return cls;
}

let UE = new Proxy(cache, {
    get : function(classWrapers, name) {
        let value = classWrapers[name];
        if (value === undefined) {
            value = loadUEType(name);
            classWrapers[name] = FNameCaseFix(value);
        }
        return value;
    }
});

优化建议

1. 使用Object.getOwnPropertyDescriptor：更安全地获取属性描述符后再进行定义
2. 静态绑定声明：对于存在同名但大小写不一致成员的特殊情况，建议添加静态绑定声明来明确指定

注意事项

1. 此方案主要解决静态函数和变量的大小写问题
2. 对于成员函数和属性，Puerts已有内置的自动修正机制
3. 在QuickJS环境下，同样可以采用类似的Proxy方案解决问题

结论

Puerts在UE5中的大小写问题主要源于FName系统的特性与JavaScript引擎之间的差异。通过Proxy代理的方式，开发者可以有效地规避这一问题，确保代码在编辑器和打包后环境中的一致性。随着Puerts的持续发展，期待未来版本能提供更完善的解决方案，从根本上解决这类兼容性问题。