Qt6中实例化hoverButton组件遇M16错误及构建失败求助

1. 修正组件实例化写法 #

错误提示“Cannot assign to non-existent property 'hoverButton'”说明你在main.qml中错误地将hoverButton作为父元素的属性赋值，而非独立组件实例化。

正确的组件实例化方式：

// 错误写法：将hoverButton当作属性赋值
Window {
    hoverButton: {} // 触发属性不存在错误
}

// 正确写法：直接实例化组件
Window {
    HoverButton { // 组件名需与文件名大小写完全匹配，遵循首字母大写约定
        x: 100
        y: 100
        text: "Hover Me"
        // 其他组件属性配置
    }
}

2. 统一组件文件名与组件名 #

QML引擎要求组件名与文件名大小写完全一致，且默认遵循首字母大写的规范：

• 将hoverButton.qml重命名为HoverButton.qml
• 在main.qml中使用HoverButton {}完成实例化

3. 确保组件文件被正确纳入构建 #

检查CMakeLists.txt配置，确认HoverButton.qml被添加到QML模块或资源中：

qt_add_executable(simple-image-viewer
    main.cpp
)

qt_add_qml_module(simple-image-viewer
    URI simple-image-viewer
    VERSION 1.0
    QML_FILES
        Main.qml
        HoverButton.qml # 必须包含该组件文件
)

target_link_libraries(simple-image-viewer
    PRIVATE Qt6::Core Qt6::Quick Qt6::Gui
)

若使用qrc资源文件，需确保组件文件被添加到资源列表：

<RCC>
    <qresource prefix="/">
        <file>Main.qml</file>
        <file>HoverButton.qml</file>
    </qresource>
</RCC>

4. 处理跨目录组件的导入 #

如果HoverButton.qml与main.qml不在同一目录，需在main.qml顶部导入对应目录：

// 假设组件在components子目录下
import "./components"

Window {
    HoverButton {}
}

5. 清除缓存并重新构建 #

删除项目的build目录，在Qt Creator中执行Build -> Clean All，再重新构建项目，避免旧缓存干扰。

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