Unreal Engine：如何创建与FVector等价且互不兼容的全局/局部坐标类型？

核心思路是创建两个强类型包装结构体，内部封装FVector成员，通过隐式转换复用FVector的所有功能，同时限制类型间的隐式交互，实现类型安全的坐标空间区分，且完全无需修改FVector基类，运行时零额外开销。

具体实现代码 #

// 全局空间坐标类型
struct FGlobalVector
{
private:
    FVector Value;

public:
    // 与FVector对齐的构造逻辑
    FGlobalVector() = default;
    FGlobalVector(float X, float Y, float Z) : Value(X, Y, Z) {}
    explicit FGlobalVector(const FVector& Vec) : Value(Vec) {}

    // 隐式转换为FVector，无缝复用原有功能
    operator FVector&() { return Value; }
    operator const FVector&() const { return Value; }

    // 显式转换到局部空间类型
    explicit FLocalVector ToLocal() const { return FLocalVector(Value); }
};

// 局部空间坐标类型
struct FLocalVector
{
private:
    FVector Value;

public:
    FLocalVector() = default;
    FLocalVector(float X, float Y, float Z) : Value(X, Y, Z) {}
    explicit FLocalVector(const FVector& Vec) : Value(Vec) {}

    operator FVector&() { return Value; }
    operator const FVector&() const { return Value; }

    // 显式转换到全局空间类型
    explicit FGlobalVector ToGlobal() const { return FGlobalVector(Value); }
};

核心特性说明 #

• 零运行时开销：包装结构体的内存布局与FVector完全一致，编译后不会产生任何额外的性能损耗，用户使用时除类型检查外无感知。
• 严格类型安全：FGlobalVector与FLocalVector之间无法隐式转换，必须通过ToGlobal()/ToLocal()显式操作，彻底避免跨空间的错误运算或参数传递。
• 无缝复用FVector能力：通过隐式转换为FVector，所有FVector的成员函数（如GetLength()、Normalize()）、全局运算符（如operator+、operator*）都能直接使用，无需重复实现。
• 无侵入式修改：完全基于包装类实现，不改动FVector的任何代码，不会影响原有代码的正常运行。

使用示例 #

// 定义明确类型的函数，参数类型清晰
void MoveActorToGlobal(FGlobalVector TargetPos)
{
    // 直接像使用FVector一样操作TargetPos
    Actor->SetActorLocation(TargetPos);
}

void ExampleUsage()
{
    FLocalVector LocalOffset(100, 200, 0);
    
    // 必须显式转换才能传入要求全局坐标的函数
    MoveActorToGlobal(LocalOffset.ToGlobal());

    // 错误示例：编译会失败，因为不支持隐式类型转换
    // MoveActorToGlobal(LocalOffset);

    // 与原生FVector交互需显式转换
    FVector RawWorldVec = FVector(0, 0, 100);
    FGlobalVector GlobalVec(RawWorldVec);
}

可选进阶优化 #

• 添加与FVector对齐的其他构造函数（如从FVector2D、FRotator初始化），进一步提升使用一致性。
• 增加静态创建方法，比如FGlobalVector::FromFVector(const FVector& Vec)，增强代码可读性。

内容的提问来源于stack exchange，提问作者Karlovsky120