如何获取单例对象的QQmlEngine实例及静态函数内的单例指针？

先梳理下你的场景：你有一个C++定义的SingletonBaseClass，通过QML文件扩展成单例（在qmldir中标记为singleton），且应用存在多个QML引擎实例，现在需要解决两个核心问题：

问题1：在SingletonBaseClass成员函数中获取所属的QQmlEngine实例 #

Qt 5.12 之前的临时解决方案 #

在Qt 5.12之前，没有直接API可以从QObject获取所属QML引擎，不过可以通过上下文间接推导：

Q_INVOKABLE void someMethodCalledFromQml() {
    QQmlContext* context = QQmlEngine::contextForObject(this);
    if (context) {
        QQmlEngine* ownerEngine = context->engine();
        // 此处已拿到当前实例所属的引擎
    }
}

这个方法的前提是当前对象已被QML引擎上下文管理，对于你的单例场景来说，只要QML完成实例化，这个逻辑就可靠。

另一种更稳妥的方式是在QML实例化时主动传递引擎：

1. 在SingletonBaseClass中添加成员变量和设置方法：

private:
    QQmlEngine* m_engine = nullptr;
public:
    Q_INVOKABLE void setEngine(QQmlEngine* engine) {
        m_engine = engine;
    }

2. 在SingletonClass.qml的完成回调中调用该方法：

SingletonBaseClass {
    Component.onCompleted: {
        setEngine(Qt.application.engine)
    }
}

Qt 5.12 及之后的官方方案 #

正如你提到的，你提交的补丁已经在Qt 5.12中落地——Qt新增了qmlEngine()全局函数，可以直接从QObject获取所属QML引擎，代码大幅简化：

Q_INVOKABLE void someMethodCalledFromQml() {
    QQmlEngine* ownerEngine = qmlEngine(this);
}

问题2：在静态函数中获取指定引擎的单例实例 #

Qt 5.12 之前的临时解决方案 #

多引擎场景下每个引擎会维护独立的单例实例，我们需要手动维护引擎与实例的映射关系：

#include <QMap>
#include <QQmlContext>

class SingletonBaseClass : public QObject {
    Q_OBJECT
private:
    static QMap<QQmlEngine*, SingletonBaseClass*> s_engineInstanceMap;
    QQmlEngine* m_engine = nullptr;

public:
    SingletonBaseClass(QObject* parent = nullptr) : QObject(parent) {
        // 构造时关联引擎与实例
        QQmlContext* context = QQmlEngine::contextForObject(this);
        if (context) {
            m_engine = context->engine();
            s_engineInstanceMap[m_engine] = this;
        }
    }

    ~SingletonBaseClass() {
        // 析构时移除映射
        if (m_engine) {
            s_engineInstanceMap.remove(m_engine);
        }
    }

    static SingletonBaseClass* instance(QQmlEngine* engine) {
        // 通过映射表获取指定引擎的实例
        return s_engineInstanceMap.value(engine, nullptr);
    }
};

// 务必在cpp文件中初始化静态成员
QMap<QQmlEngine*, SingletonBaseClass*> SingletonBaseClass::s_engineInstanceMap;

Qt 5.12 及之后的官方方案 #

同样得益于你的贡献，Qt 5.12新增了QQmlEngine::singletonInstance()模板方法，可直接根据类型获取指定引擎下的单例实例，静态函数可以写成：

#include <QQmlEngine>
#include <QtQml>

static SingletonBaseClass* instance(QQmlEngine* engine) {
    return engine->singletonInstance<SingletonBaseClass>();
}

[更新]：我对建议的workaround方案不满意，最终为此提交了补丁（针对问题1）以及QQmlEngine::singletonInstance()（针对问题2），这两项改动将在Qt 5.12中可用。

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