自定义QML模块导入失败，寻求解决方案

以下是针对多模块Qt项目中QML模块导入失败的逐一排查和修复步骤：

1. 检查CustomViews模块的CMake配置正确性 #

QML模块的核心配置依赖qt_add_qml_module，必须确保以下参数完全匹配：

• URI与版本严格一致：如果QML中写import CustomViews 1.0，CMake里的URI必须是CustomViews（大小写敏感），VERSION必须为1.0，不能有拼写或大小写错误。
• 正确关联模块目标：主项目需要链接该模块的目标，或者通过qt_import_qml_plugins确保插件被构建部署。
• QML文件与资源路径：确保QML_FILES字段包含模块下所有需要暴露的QML文件；如果使用资源前缀，RESOURCE_PREFIX默认是/qt/qml/${URI}，不能随意修改，否则会导致Qt无法找到模块资源。

示例CustomViews模块的CMakeLists.txt：

qt_add_qml_module(CustomViews
    URI CustomViews
    VERSION 1.0
    QML_FILES
        Button.qml
        Card.qml
    # 若有C++实现则添加SOURCES
    # SOURCES customviews.cpp customviews.h
)

# 让主项目能访问该模块
target_link_libraries(${PROJECT_NAME} PRIVATE CustomViews)

2. 正确配置QML_IMPORT_PATH #

不要手动硬编码路径，用CMake变量自动指向构建输出目录：
在主项目的CMakeLists.txt中添加：

# 指向构建目录下的qml文件夹，Qt会自动将模块插件生成到这里
set(QML_IMPORT_PATH ${CMAKE_BINARY_DIR}/qml CACHE STRING "QML import paths" FORCE)

多模块项目中，每个子模块的构建产物会自动放到${CMAKE_BINARY_DIR}/qml/${URI}下，主项目只需将根目录加入导入路径即可。

3. 确保模块在主项目中可见 #

• 主项目的CMakeLists.txt必须通过add_subdirectory(CustomViews)将子模块纳入构建流程，否则主项目无法识别该模块的配置。
• 子模块的CMakeLists.txt必须放在对应模块的根目录下（比如CustomViews/CMakeLists.txt），不能乱放路径。

4. 清理构建缓存并重新构建 #

旧的CMake缓存经常会导致路径或配置不生效：

1. 删除整个构建目录（比如build/文件夹）
2. 重新运行CMake配置（cmake ..）
3. 重新编译项目
4. 检查构建目录下的qml/CustomViews是否生成了插件文件（Windows下的.dll、Linux下的.so、macOS下的.dylib，以及必有的.qmldir文件），如果没有生成，说明模块的CMake配置存在语法或依赖错误。

5. 检查QML导入语法 #

• 导入语句必须带版本号，不能省略：import CustomViews 1.0，版本号要和CMake中的VERSION完全一致。
• 检查URI拼写，比如customviews和CustomViews是两个完全不同的模块名，Qt对大小写敏感。

内容的提问来源于stack exchange，提问作者Pieter Van Itterbeeck