Qt6 Android CMake项目无法找到Core组件问题求助

DevOps 小满

2026-5-11

关于Qt6 Android + CMake组件缺失及MaintenanceTool套件丢失问题的解决建议

一、CMake找不到Qt6 Core/Quick组件的排查与解决

从你遇到的报错来看，CMake能定位到Qt6的主配置文件，但找不到Core和Quick组件，大概率是组件安装不全或者CMake的平台配置有问题，试试这些步骤：

检查Qt6 Android套件的组件完整性
打开Qt MaintenanceTool，找到已安装的Qt6 Android版本（比如6.0.0 android_armv7），展开后确认Qt Core、Qt Quick以及它们对应的CMake模块组件是否都已安装。有时候默认安装会漏掉一些CMake相关的配套文件，你可以直接去C:/Qt/6.0.0/android_armv7/lib/cmake/目录下看是否存在Qt6Core和Qt6Quick文件夹，如果没有，说明组件没装全，重新运行MaintenanceTool补装即可。

手动指定CMake的组件查找路径
可以在项目的CMakeLists.txt里，在find_package之前手动添加组件的路径，帮CMake精准定位：

# 先指定Qt6组件的cmake目录
set(CMAKE_PREFIX_PATH "C:/Qt/6.0.0/android_armv7/lib/cmake")
# 再执行查找
find_package(Qt6 REQUIRED COMPONENTS Core Quick)

如果还是不行，也可以单独指定每个组件的路径：

set(CMAKE_PREFIX_PATH 
    "C:/Qt/6.0.0/android_armv7/lib/cmake/Qt6Core"
    "C:/Qt/6.0.0/android_armv7/lib/cmake/Qt6Quick"
)

确认Android环境配置是否正确
Qt6 Android套件对Android NDK/SDK的版本有要求（比如Qt6.0.0推荐NDK r21e，SDK API Level不低于21），你需要确保CMake已经正确识别这些路径。可以在配置CMake时手动传入参数：
```
-DCMAKE_ANDROID_NDK=你的NDK路径
-DCMAKE_ANDROID_SDK=你的SDK路径
-DCMAKE_ANDROID_API_LEVEL=21
```
环境变量配置错误的话，CMake会无法匹配Android平台的Qt组件。

这个应该是Qt MaintenanceTool的版本兼容性Bug，Qt5和Qt6的Android套件在安装时的冲突处理逻辑有问题，试试这些临时解决方法：

自定义安装Qt5 Android套件，避免自动覆盖
运行MaintenanceTool选择“添加或移除组件”后，找到Qt5.12.10的Android套件，手动勾选你需要的具体组件，不要选“全选”，同时注意安装选项里是否有“替换现有组件”之类的选项，尽量取消勾选。
提前备份Qt6 Android套件目录
在安装Qt5之前，把C:/Qt/6.0.0下的所有Android套件目录（比如android_armv7、android_arm64等）复制到其他位置，安装完成后再复制回去。虽然是临时办法，但能快速恢复被删除的Qt6套件。
分开使用不同版本的MaintenanceTool
不要用Qt5的MaintenanceTool来管理Qt6组件，反之亦然。可以单独下载对应版本的MaintenanceTool，分别管理Qt5和Qt6的套件，这样能减少版本间的冲突。

另外，既然你提到这是已上报的官方Bug，建议关注官方的修复进展，同时也可以尝试升级到Qt6的更高版本（比如6.2.x及以上），新版本通常会修复这类安装和CMake配置的问题。

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