Conan+CMake+Qt联合构建报错 未找到目标有效Qt版本

Conan 1.x 版本默认生成的conanbuildinfo.cmake仅导出依赖的头文件搜索路径、库路径等基础变量，不会自动修改CMake的find_package搜索优先级与路径列表，这和vcpkg通过工具链文件全局注入搜索规则的集成逻辑完全不同。两个报错属于连锁反应：

• 开启CMAKE_AUTOMOC时，CMake会自动检测当前工程已引入的Qt版本，未提前完成Qt包查找的情况下，AUTOMOC会判定无有效Qt版本并自动禁用
• 手动调用find_package(Qt5 COMPONENTS Core)时，由于Conan未将Qt的包配置文件路径加入CMake搜索路径，CMake走默认系统路径查找，自然无法定位到Qt提供的包配置文件。

方案1：适配Conan 1.x（当前使用版本） #

在include(${CMAKE_BINARY_DIR}/conanbuildinfo.cmake)之后，必须先执行Conan提供的初始化宏注入依赖查找路径，再做Qt相关配置，顺序不能打乱：

# 第一步：引入conan生成的配置文件
include(${CMAKE_BINARY_DIR}/conanbuildinfo.cmake)
# 关键步骤：执行conan初始化，自动配置所有依赖的查找路径、编译参数
conan_basic_setup(NO_OUTPUT_DIRS TARGETS)

# 路径注入完成后再查找Qt包
find_package(Qt5 COMPONENTS Core REQUIRED)
# 最后开启AUTOMOC等Qt自动处理开关
set(CMAKE_AUTOMOC ON)
set(CMAKE_AUTORCC ON)
set(CMAKE_AUTOUIC ON)

# 正常添加工程目标、链接依赖即可
add_executable(ProjQt src/main.cpp)
target_link_libraries(ProjQt PRIVATE Qt5::Core)

注意：conan_basic_setup必须写在所有find_package调用之前，否则路径注入不会生效。需提前确认conanfile.txt/conanfile.py中已经正确添加对应版本的Qt依赖，且conan install执行过程无报错。

如果执行上述步骤后仍找不到Qt包，可在conan_basic_setup之后手动追加Qt的包路径到搜索列表：

list(APPEND CMAKE_PREFIX_PATH ${CONAN_QT_ROOT})

方案2：升级到Conan 2.x（集成体验对齐vcpkg） #

Conan 2.x默认使用CMakeDeps生成器，会直接为所有依赖生成标准CMake包配置文件，搭配工具链文件可实现无侵入的依赖查找，不需要在CMakeLists中写Conan专属逻辑：

1. 在conan配置文件中声明生成器与依赖：

   from conan import ConanFile
   class ProjRecipe(ConanFile):
       requires = "qt/5.15.10" # 替换为实际使用的Qt版本
       generators = "CMakeDeps", "CMakeToolchain"
   

2. 执行依赖安装后，配置CMake时指定Conan生成的工具链即可，不需要手动include conanbuildinfo.cmake：

   cmake -B build -DCMAKE_TOOLCHAIN_FILE=build/conan_toolchain.cmake
   

3. CMakeLists.txt按标准Qt工程写法编写即可，不需要额外适配Conan：

   project(ProjQt)
   find_package(Qt5 COMPONENTS Core REQUIRED)
   set(CMAKE_AUTOMOC ON)
   add_executable(ProjQt src/main.cpp)
   target_link_libraries(ProjQt PRIVATE Qt5::Core)
   

• 禁止在执行conan_basic_setup之前调用任何find_package，否则Conan注入的路径不会生效
• 若环境中同时安装了系统级Qt和Conan管理的Qt，可在find_package时添加NO_DEFAULT_PATH参数，强制优先匹配Conan安装的版本
• 需保证Conan安装Qt时的编译配置和当前工程配置一致（编译模式、编译器版本、系统架构完全匹配），否则会出现找到包但链接失败的问题

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