Qt 5.15.2中能否将第三方库枚举注册到MOC用于QML且不重复定义？

我有一个来自第三方库的枚举类型：

namespace Lib {
  enum class Foo {
    Bar,
    Baz
  };
};

我尝试用以下包装器结合qmlRegisterUncreatableMetaObject将其注册到Qt元对象系统以用于QML，但未成功：

namespace Qml {
    Q_NAMESPACE
    using Foo = Lib::Foo;
    Q_ENUMS(Foo)
}

请问能否在不重复定义枚举逻辑（如下示例的方式）的前提下完成注册？

class QmlObject {
    Q_GADGET

public:
    enum Foo {
        Bar = Lib::Bar,
        Baz = Lib::Baz
    };
    Q_ENUM(Foo)
};

使用Qt版本：5.15.2

在Qt 5.15.2中，直接通过using别名在带Q_NAMESPACE的命名空间里注册第三方枚举确实无法生效，因为Qt的元对象编译器（moc）无法识别别名指向的外部枚举类型。不过可以通过以下两种方式实现无重复逻辑的注册：

方法1：利用Q_ENUM_NS配合命名空间注册 #

Qt 5.14及以上支持Q_ENUM_NS宏，专门用于在命名空间中注册枚举。只需在包装命名空间内创建与原枚举值完全对齐的强类型枚举（仅数值映射，无重复逻辑），即可满足moc的要求：

#include <QObject>

namespace Lib {
  enum class Foo {
    Bar,
    Baz
  };
};

// 包装命名空间
namespace Qml {
    Q_NAMESPACE
    enum class Foo {
        Bar = Lib::Foo::Bar,
        Baz = Lib::Foo::Baz
    };
    Q_ENUM_NS(Foo)
}

// 在初始化函数中注册到QML
qmlRegisterUncreatableMetaObject(Qml::staticMetaObject, "MyQmlEnums", 1, 0, "Foo", "Enum cannot be created");

这种方式只是映射了原枚举的数值，没有重复编写枚举的业务逻辑，同时规避了moc无法识别外部枚举的限制。

方法2：使用Q_DECLARE_METATYPE+手动元对象注册 #

如果不想创建枚举别名，还可以通过声明元类型并手动将其注册到QML：

1. 先为第三方枚举声明元类型：

#include <QMetaType>
#include <QQmlEngine>

namespace Lib {
  enum class Foo {
    Bar,
    Baz
  };
};

// 声明元类型，让Qt识别该枚举
Q_DECLARE_METATYPE(Lib::Foo)

2. 在程序初始化阶段完成QML注册：

int main(int argc, char *argv[]) {
    QCoreApplication::setAttribute(Qt::AA_EnableHighDpiScaling);
    QGuiApplication app(argc, argv);

    // 注册元类型到QML类型系统
    qRegisterMetaType<Lib::Foo>("Lib::Foo");
    // 获取枚举的元对象并注册到QML，使其能在QML中通过名称访问枚举值
    const QMetaObject* metaObj = QMetaType::metaObjectForType(qMetaTypeId<Lib::Foo>());
    if (metaObj) {
        int enumIdx = metaObj->indexOfEnumerator("Foo");
        if (enumIdx != -1) {
            qmlRegisterUncreatableMetaObject(metaObj, "Lib", 1, 0, "Foo", "Cannot create enum instance");
        }
    }

    QQmlApplicationEngine engine;
    const QUrl url(QStringLiteral("qrc:/main.qml"));
    QObject::connect(&engine, &QQmlApplicationEngine::objectCreated,
                     &app, [url](QObject *obj, const QUrl &objUrl) {
        if (!obj && url == objUrl)
            QCoreApplication::exit(-1);
    }, Qt::QueuedConnection);
    engine.load(url);

    return app.exec();
}

注意：需要确保第三方枚举的头文件被moc正确扫描，可在项目的.pro文件中添加QT += core qml，并将包含枚举声明的头文件加入moc处理列表。

关键原因说明 #

原代码中使用Q_ENUMS+using别名的方式失败，核心原因是moc只能处理当前编译单元内直接定义的枚举，无法解析using指向的外部枚举类型。Q_ENUM_NS或元类型注册的方式，本质是让moc能直接识别到枚举的定义或元类型信息，从而完成元对象系统的注册。

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