CMake中find_package的NAMES选项工作原理及版本变量生成疑问

一、NAMES选项的实际工作逻辑 #

NAMES选项的作用是给CMake指定备选的包名称列表，CMake会按顺序尝试查找这些名称对应的包配置文件，但有两个核心规则必须明确：

1. 无论NAMES里写了多少备选名称，CMake最终生成的所有关联变量（比如XXX_FOUND、XXX_DIR）都是基于你在find_package第一个参数传入的原始包名，而非实际找到的备选包名。
2. 仅当开启了CMAKE_FIND_PACKAGE_REDIRECTS_DIR且该目录下存在备选名称对应的配置文件时，CMake才会强制优先使用该备选包的配置，但变量依然绑定原始包名。

结合你贴出的CMake源码片段来看：当重定向目录中存在Qt5Config.cmake这类文件时，CMake会强制切换到该配置的查找逻辑，但最终生成的变量还是以原始包名为前缀，而非Qt5。

二、为什么ghasem_MAJOR_VERSION无法生成 #

你修改后的代码：

find_package(ghasem NAMES Qt6 Qt5 COMPONENTS Core REQUIRED)
find_package(Qt${ghasem_MAJOR_VERSION} COMPONENTS Core REQUIRED)

出现问题的原因很直接：

• CMake本身不会自动为自定义的原始包名（比如ghasem）生成XXX_MAJOR_VERSION这类版本变量，这不是CMake的默认行为。
• Qt的官方配置文件（Qt5Config.cmake/Qt6Config.cmake）只会设置Qt5_MAJOR_VERSION或Qt6_MAJOR_VERSION，不会主动生成ghasem_MAJOR_VERSION。
• 你用ghasem作为原始包名，CMake只会生成ghasem_FOUND、ghasem_DIR这类标准变量，不会自动映射到Qt的版本信息。

而Qt Creator模板里的写法能生效，是因为Qt专门为QT这个虚拟包名提供了配套的配置逻辑——Qt的QTConfig.cmake会主动设置QT_MAJOR_VERSION变量，把找到的Qt版本号传递出来，这是Qt自定义的逻辑，不是CMake的通用规则。

三、正确的替代写法 #

如果想自定义包名逻辑来查找Qt，需要手动处理版本变量，比如：

# 先尝试查找Qt6，失败则回退到Qt5
find_package(Qt6 COMPONENTS Core QUIET)
if(NOT Qt6_FOUND)
    find_package(Qt5 COMPONENTS Core REQUIRED)
    set(MY_QT_VERSION 5)
else()
    set(MY_QT_VERSION 6)
endif()

# 后续使用指定版本的Qt
find_package(Qt${MY_QT_VERSION} COMPONENTS Core REQUIRED)

或者直接沿用Qt官方提供的QT虚拟包名写法，也就是模板里的代码，因为Qt已经帮你处理好了版本变量的生成逻辑。

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