指定目录不等于指定版本，CMake可能加载非预期Qt版本，因CMAKE_PREFIX_PATH仅控制搜索起点，需配合EXACT版本约束、Qt6_DIR精确指向或验证Qt6Config.cmake中的VERSION_STRING声明。
直接结论：指定目录 ≠ 指定版本，CMake 仍可能加载该目录下“非预期”的 Qt 或其他包版本。 常见现象是：你明明把 CMAKE_PREFIX_PATH 设为 /opt/Qt/6.7.3/gcc_64，find_package(Qt6 REQUIRED) 却链接了 6.5.3，甚至报错说找不到 Core 组件——根本原因不是路径错了，而是 CMake 在那个目录里找到了多个 Qt6Config.cmake，或该目录结构本身不满足版本校验逻辑。
为什么 set(CMAKE_PREFIX_PATH ...) 后版本还是不对？
因为 CMAKE_PREFIX_PATH 只控制搜索起点，不控制“在该路径里选哪个子目录”。CMake 会遍历 /opt/Qt/6.7.3/gcc_64 下所有可能的 lib/cmake/Qt6* 子路径（比如 lib/cmake/Qt6.5.3、lib/cmake/Qt6.7.3、lib/cmake/Qt6），并按内部规则选一个匹配的。如果 Qt6Config.cmake 文件里声明的版本号和你期望不符，或者它被软链接/重定向到旧版，CMake 就不会用它。
-
Qt6Config.cmake文件本身必须包含set(Qt6_VERSION_STRING "6.7.3")这类声明，且该值要和find_package(Qt6 6.7.3 EXACT)中的版本严格一致 - 某些 Qt 安装包（尤其在线安装器）会在
lib/cmake/Qt6下放一个“通用”配置文件，它不带具体版本号，CMake 会把它当作Qt6的“默认入口”，但实际加载的可能是子目录里最早发现的版本 -
CMAKE_PREFIX_PATH中多个路径叠加时，CMake 会按顺序扫描，前一个路径里若有低版本Qt6Config.cmake，就可能跳过你后指定的高版本路径
强制锁定 Qt6 版本的实操写法
光设 CMAKE_PREFIX_PATH 不够，必须配合版本约束和路径微调：
- 在
find_package()中显式加EXACT和版本号：find_package(Qt6 6.7.3 EXACT REQUIRED) - 确保
CMAKE_PREFIX_PATH只包含目标 Qt 安装根目录（即含lib/cmake/Qt6.7.3/Qt6Config.cmake的那个路径），不要包含其父级（如/opt/Qt）或兄弟目录 - 用
Qt6_DIR变量直接指向配置文件所在目录，绕过路径搜索：set(Qt6_DIR "/opt/Qt/6.7.3/gcc_64/lib/cmake/Qt6.7.3")，再调用find_package(Qt6 REQUIRED) - 检查目标目录下是否存在
lib/cmake/Qt6.7.3/Qt6Config.cmake，而不是只有lib/cmake/Qt6/Qt6Config.cmake；后者通常只是转发器，实际版本由内部逻辑决定
Qt5 和 Qt6 混用时最容易踩的坑
如果你项目同时用 find_package(Qt5) 和 find_package(Qt6)，CMake 会把它们当成完全独立的包，但底层变量（如 Qt5_DIR 和 Qt6_DIR）互不干扰——这看似安全，实则危险：
- 两个包可能共用同一套
Qt5Core/Qt6Core库路径，若系统 PATH 或LD_LIBRARY_PATH混入旧版库，运行时会崩溃 -
find_package(Qt5 5.15.2 EXACT)成功，不代表find_package(Qt6 6.7.3 EXACT)也成功；必须分别验证每个_FOUND变量 - Qt 官方建议：同一构建中不要混用 Qt5 和 Qt6 的 target（如
target_link_libraries(myapp Qt5::Core)和Qt6::Core），链接器可能无法区分符号冲突
最常被忽略的一点：Qt 的 Config.cmake 文件是否真的“自洽”。有些离线安装包解压后，Qt6.7.3/ 目录下的 Qt6Config.cmake 会通过 include() 加载上级目录的通用逻辑，而那个通用逻辑可能读取环境变量或硬编码了错误版本。动手前先 grep -r "VERSION_STRING" /opt/Qt/6.7.3/gcc_64/lib/cmake/Qt6.7.3/ 确认真实声明值。
