使用qmlRegisterSingletonType创建单例类时QML报错‘Element is not creatable’

这个问题的核心是你误解了QML单例类型的使用方式——单例类型是全局唯一的，不能在QML中通过TestSingletonType {}手动实例化，这也是你看到"Element is not creatable"错误的原因。

错误原因解析 #

qmlRegisterSingletonType注册的是一个全局单例，QML引擎会自动调用你提供的qmlInstance函数创建唯一实例，你不需要（也不允许）像普通组件那样在QML里写TestSingletonType { ... }来创建它。而你之前用qmlRegisterType能正常运行，是因为这个函数注册的是可实例化的普通组件，和单例的逻辑完全不同。

修复步骤 #

1. 修正QML中的使用方式

删除QML里的TestSingletonType { id: mySingleClass }代码块，直接通过类型名TestSingletonType访问单例的属性或方法。比如：

import QtQuick 2.0
import QtQuick.Controls 2.0
import com.my.TestSingletonType 1.0

Item {
    Component.onCompleted: {
        console.log("单例已就绪");
        // 假设你的TestSingletonType有一个名为testProp的Q_PROPERTY，直接这样访问
        // console.log(TestSingletonType.testProp);
    }
}

2. 确保C++单例实现完整

检查你的TestSingletonType.cpp文件，确认静态成员theInstance已经正确初始化：

#include "TestSingletonType.h"

QObject* TestSingletonType::theInstance = nullptr;

你的构造函数是private的，这没问题——静态成员函数qmlInstance可以访问private构造函数，保证单例的唯一性。

额外说明 #

如果需要给单例设置属性，你有两种方式：

• 在qmlInstance函数中创建实例时直接初始化；
• 给TestSingletonType添加可写的Q_PROPERTY，在QML中通过TestSingletonType.someProperty = "value"的方式设置。

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