QML引用外部类枚举属性触发qmlsc/qmlint报错的解决方法

现有包含枚举定义的类ClassA，代码如下：

class ClassA : public QObject
{
    Q_OBJECT
    QML_ELEMENT
    
public:
    enum EnumClassA {
    };
    Q_ENUM(EnumClassA)
    
};

第二个类ClassB中定义了类型为ClassA::EnumClassA的属性，代码如下：

#include <ClassA.h>
class ClassB : public QObject
{
    Q_OBJECT
    QML_ELEMENT
    
    Q_PROPERTY(ClassA::EnumClassA value READ ...)
public:
    
};

上述写法在QML运行时可正常工作，value属性可以在QML中正常访问，但使用qmlint/qmlsc做静态检查/编译时会抛出如下错误：

error: Could not compile binding for value: Cannot generate efficient code for content pointer of non-QVariant wrapper type double of ClassB::value with type ClassA::EnumClassA

临时修复方案是将属性声明中的枚举类型替换为int：

// 替换原Q_PROPERTY(ClassA::EnumClassA value READ ...)
Q_PROPERTY(int value READ ...)

但该方案会丢失枚举类型信息，无法在QML端获得枚举值提示、类型校验能力，需要在保留原枚举类型声明的前提下解决编译报错。

这个报错的核心原因是qmlsc做静态高效代码生成时，要求跨类引用的枚举必须完成完整的Qt元类型注册，仅在类内部使用Q_ENUM宏不足以让静态编译器识别跨类使用的枚举元信息，按以下步骤调整即可：

• 在ClassA的头文件中，类定义的外部全局作用域添加元类型声明宏：

// ClassA类定义结束后添加
Q_DECLARE_METATYPE(ClassA::EnumClassA)

• 确认ClassB的头文件中是通过#include <ClassA.h>引入ClassA定义，不要仅对ClassA做前置声明，前置声明会让qmlsc无法解析到枚举的元注册信息。

调整后无需修改Q_PROPERTY的类型声明，保留ClassA::EnumClassA即可正常通过qmlsc/qmlint的检查，同时完整保留枚举的类型信息，QML端可以正常识别枚举值、获得类型校验能力。
如果该枚举还需要作为信号参数、跨线程队列连接参数使用，可以在初始化代码中额外添加qRegisterMetaType<ClassA::EnumClassA>();，仅解决qmlsc编译报错的话不需要这一步。

运行时QML能正常工作是因为Qt运行时元对象系统可以动态解析类内Q_ENUM注册的枚举信息，但qmlsc的静态编译模式需要显式的元类型声明才能生成无动态查表的高效访问代码。

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