Qt 6.4.2项目QML中TestClass1类型不可用错误求助

问题说明 #

在Qt 6.4.2中创建的测试项目包含TestClass1和TestClass2两个QML类，启动程序时出现异常：

qrc:/testTypeProject/main.qml:11:5: Type TestClass1 unavailable

项目代码 #

TestClass1.qml #

import QtQuick 2.0

Item {
    id: root

    property int counter: 0

    property TestClass2 testClass2: TestClass2 {
        testClass1: root
    }
}

TestClass2.qml #

import QtQuick 2.0
import QtQml
import QtQuick.Controls

Item {

    //! 在TestClass2中处理TestClass1
    property TestClass1 testClass1

    property Timer _timer: Timer {
        repeat: true
        running: true
        interval: 1000
        onTriggered: {
         testClass1.counter++;
            console.debug("testClass1.counter = ", testClass1.counter);
        }
    }
}

main.qml #

import QtQuick 2.0
import QtQuick.Controls

Window {
    width: 640
    height: 480
    visible: true
    title: qsTr("Hello World")

    property TestClass1 testClass1: TestClass1 {

    }
}

解决步骤 #

• 检查资源文件配置：确认TestClass1.qml和TestClass2.qml已正确添加到项目的.qrc资源文件中，且文件路径能被main.qml访问。如果类文件放在子目录下，需要在main.qml中导入对应目录，比如import "./components"（假设类在components文件夹内）。
• 修复循环引用问题：当前两个类互相声明对方类型，会导致QML引擎无法解析。两种修复方式：
  1. 改用var类型：将TestClass1中的property TestClass2 testClass2改为property var testClass2，TestClass2中的property TestClass1 testClass1改为property var testClass1，绕过类型解析时的循环依赖。
  2. 延迟实例化：在TestClass1的Component.onCompleted信号中创建TestClass2实例并赋值，避免初始化阶段的互相依赖。
• 统一Qt版本导入：Qt 6.4.2中建议使用import QtQuick 6.4替代QtQuick 2.0，高版本Qt对旧导入版本的兼容可能存在问题，统一使用对应Qt 6的版本导入可减少类型识别错误。
• 清理缓存并重建：执行Build > Clean All清理项目缓存，重新构建后再运行，避免Qt Creator缓存导致的类型无法识别问题。

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