CMake导入C++元素到QML时Qt Creator虚假警告的解决办法

问题现象 #

按照官方文档《从C定义QML类型——注册可实例化对象类型》创建基础C自定义QML元素后，在Main.qml中使用时出现4条虚假导入警告，警告不影响程序构建与运行，但会干扰开发过程中的代码排查：

• D:\Downloads\CppIntegrationTest\Main.qml:2: warning: Warnings occurred while importing module "CppIntegrationTest": [import]
• D:\Downloads\CppIntegrationTest\Main.qml:1: warning: Failed to import CppIntegrationTest. Are your import paths set up properly? [import]
• D:\Downloads\CppIntegrationTest\Main.qml:10: warning: Foo was not found. Did you add all imports and dependencies?: Did you mean "Flow"? [import]
• D:\Downloads\CppIntegrationTest\Main.qml:10: warning: Type Foo is used but it is not resolved [unresolved-type]

环境信息 #

• Qt Creator 14.0.2
• Qt 6.7.3
• Windows 10 操作系统

项目文件结构 #

CppIntegrationTest
|-- CMakeLists.txt
|-- foo.cpp
|-- foo.h
|-- main.cpp
|-- Main.qml

错误原因 #

问题出在CMakeLists.txt的qt_add_qml_module配置中：SOURCES foo.h foo.cpp被错误嵌套在QML_FILES的参数列表里，导致Qt Creator的代码模型无法正确识别C++源文件属于该QML模块，进而触发虚假的导入和类型未解析警告。

解决方案 #

1. 修正CMakeLists.txt配置 #

修改qt_add_qml_module部分，将SOURCES作为独立参数项，与QML_FILES分开：

修改前的错误配置：

qt_add_qml_module(appCppIntegrationTest
    URI CppIntegrationTest
    VERSION 1.0
    QML_FILES
        Main.qml
        SOURCES foo.h foo.cpp
)

修改后的正确配置：

qt_add_qml_module(appCppIntegrationTest
    URI CppIntegrationTest
    VERSION 1.0
    QML_FILES
        Main.qml
    SOURCES 
        foo.h foo.cpp
)

2. 重新配置并构建项目 #

在Qt Creator中执行以下操作：

• 点击左侧项目面板，找到构建部分的Run CMake按钮，重新生成项目配置
• 执行完整的项目构建

3. 清除Qt Creator缓存（可选） #

如果警告仍未消失，清除Qt Creator的代码模型缓存并重启：

1. 点击菜单栏工具 -> 选项
2. 在弹窗中选择C++ -> Code Model
3. 点击Clear Cache按钮
4. 关闭并重新启动Qt Creator

验证 #

完成上述步骤后，打开Main.qml文件，检查之前的4条警告是否已消失。

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