cmake找不到qt6config.cmake的根本原因是find_package无法定位qt6安装路径及对应模块；需确认qt6安装完整（如勾选widgets、编译器工具链）、设置cmake_prefix_path指向qt根目录（如c:/qt/6.8.0/msvc2022_64），并确保cmake≥3.16。
CMake 装完不能直接用 Qt 项目，必须让 CMake 知道 Qt 在哪、用哪个版本、怎么链接模块——否则 find_package 会报错“Could not find Qt6Config.cmake”或“Package Qt6Widgets not found”。
确认 Qt 安装路径和组件是否完整
Qt 官方在线安装器默认不勾选全部内容，find_package(Qt6 REQUIRED COMPONENTS Widgets) 失败，大概率是没装对应工具链或模块：
- Windows 下用 MinGW 编译，必须勾选
MinGW 11.2.0 64-bit（或你实际用的版本），不能只装sources或debugging tools - 用 MSVC 编译，必须勾选
MSVC 2022 64-bit，且系统已装 Visual Studio 2022（不是仅装 Build Tools） -
Widgets模块在安装时要手动展开Qt 6.x.x→Qt Libraries→ 勾选Qt Widgets；Qt6 默认不装它，Qt5 则通常自带 - 检查安装目录是否存在
Qt6Config.cmake：比如C:\Qt\6.8.0\msvc2022_64\lib\cmake\Qt6\Qt6Config.cmake，路径不存在说明组件没装对
CMake 找不到 Qt 的三种解决方式（按优先级排序）
不是所有方式都通用，取决于你是用 Qt Creator、VS Code 还是命令行调用 cmake：
- Qt Creator 自动注入：
CMAKE_PREFIX_PATH由 IDE 内部设置，只要 Kit 配置正确（Tools → Options → Kits → Desktop Qt），新建项目就能通过。但移动项目文件夹后，Kit 可能失效，需重新指定 Qt 版本和编译器 - 命令行显式传参（最可靠）：
cmake -DCMAKE_PREFIX_PATH="C:/Qt/6.8.0/msvc2022_64" ..，路径末尾不能带/lib/cmake，必须是 Qt 安装根目录 - 环境变量（慎用）：
set CMAKE_PREFIX_PATH=C:\Qt\6.8.0\msvc2022_64（Windows）或export CMAKE_PREFIX_PATH=$HOME/Qt/6.8.0/gcc_64（Linux/macOS），但会影响所有 CMake 项目，容易冲突
CMakeLists.txt 中 Qt6 和 Qt5 的写法差异
Qt6 强制要求 qt_add_executable() 和 qt_standard_project_setup()，Qt5 不支持这些函数，混用会报错：
- Qt6 必须启用自动 MOC/UIC/RCC：
set(CMAKE_AUTOMOC ON)、set(CMAKE_AUTOUIC ON)、set(CMAKE_AUTORCC ON)；Qt5 可以用但非必需 - Qt6 推荐写法：
find_package(Qt6 REQUIRED COMPONENTS Widgets)+qt_add_executable(myapp main.cpp mainwindow.ui)+target_link_libraries(myapp PRIVATE Qt6::Widgets) - Qt5 兼容写法：
find_package(Qt5 REQUIRED COMPONENTS Widgets)+add_executable(myapp main.cpp mainwindow.ui)+target_link_libraries(myapp PRIVATE Qt5::Widgets)，但需手动调用qt5_wrap_ui()或启用AUTOMOC - Qt6 不再支持
QT5_WRAP_UI等宏，Qt5 也不认qt_add_executable，版本错配会导致 CMake configure 直接失败
常见报错和对应修复点
报错信息本身已经指明问题方向，别急着搜解决方案，先看关键字段：
-
Could NOT find Qt6 (missing: Widgets)→ Qt6 安装路径下lib/cmake/Qt6Widgets/不存在，重装 Qt6 并勾选 Widgets 模块 -
Unknown CMake command "qt_add_executable"→ CMake 版本太低（Qt6 要求 ≥3.16），或find_package(Qt6)失败导致后续函数未加载 -
main.cpp: error: 'QApplication' was not declared in this scope→target_link_libraries没加Qt6::Widgets，或用了Qt6::Core却没引入 Widgets 模块 - 构建后窗口一闪而逝 → Windows 下没加
set(CMAKE_WIN32_EXECUTABLE ON)，导致程序以控制台模式启动，GUI 窗口随 main 返回立即关闭
真正卡住的地方往往不是语法，而是 Qt 安装路径、CMake 版本、组件勾选三者之间没对齐。每次改完配置，删掉 build 目录重来，比反复试错快得多。
