如何在CMake中导入QtQuickControls？Qt5.10.1构建QML项目遇版本错误

这个问题的核心很明确：CMake默认的搜索路径没有包含你安装在Home目录的Qt 5.10.1，而是找到了系统预装的旧版本Qt（比如只支持QtQuick 2.9的版本），所以才会出现版本不匹配的报错。下面是具体的解决步骤：

• 明确告诉CMake你的Qt安装路径
  你需要让CMake知道Home目录里的Qt位置，有两种方式：

  1. 在你的CMakeLists.txt最开头添加路径设置（替换成你实际的Qt安装路径，比如macOS下可能是~/Qt/5.10.1/clang_64）：

     set(CMAKE_PREFIX_PATH "/home/你的用户名/Qt/5.10.1/gcc_64")
     

  2. 或者在执行cmake命令时通过参数指定：

     cmake .. -DCMAKE_PREFIX_PATH=/home/你的用户名/Qt/5.10.1/gcc_64
     

• 强制CMake查找指定版本的Qt
  修改find_package语句，明确指定Qt 5.10.1版本和需要的组件，避免CMake匹配到旧版本：

  find_package(Qt5 5.10.1 REQUIRED COMPONENTS Quick QuickControls2)
  

• 匹配QML导入版本与Qt版本
  确保你的QML文件里的导入版本和Qt 5.10.1对应的版本一致：

  import QtQuick 2.10
  import QtQuick.Controls 2.3
  

• 如果用Qt Creator，直接配置项目Qt版本
  打开Qt Creator的项目设置，在"Build & Run"选项卡的"Kit"部分，选择你安装在Home目录的Qt 5.10.1对应的套件。Qt Creator会自动帮你配置CMake的搜索路径，不用手动修改代码或命令行参数。

按照上面的步骤操作后，CMake就能正确找到你需要的Qt版本，QML模块的版本错误也会随之解决。

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