conan 2.x 必须用 cmakedeps 生成 config 文件并配合 find_package(config) 使用,否则因默认模块模式找不到包;需正确设置 cmake_file_name、使用 :: 导入目标、避免手动 include_directories,且每次升级应清理 build 目录。

Conan 2.x 必须用 CMakeDeps + find_package(CONFIG)
Conan 2.x 不再默认生成 FindXXX.cmake 模块,直接写 find_package(fmt REQUIRED) 会失败——CMake 默认走模块模式(module mode),而 Conan 2.x 只提供配置模式(config mode)的 fmtConfig.cmake。必须显式加 CONFIG 关键字,否则找不到。
正确写法是:
find_package(fmt CONFIG REQUIRED)
这要求 Conan 先通过 CMakeDeps 生成对应 Config 文件。运行 conan install 时得指定该生成器:
conan install . --output-folder=build --build=missing -g CMakeDeps -g CMakeToolchain- 生成的
fmt-config.cmake会落在build/Release/generators/(或build/generators/,取决于 profile 设置) -
CMakeLists.txt中需先include()工具链,再find_package(),顺序不能反
target_link_libraries 里要用 :: 而不是 _LIBRARIES
旧式 CMake 写法常依赖 ${Boost_LIBRARIES} 这类变量,但 Conan 2.x + CMakeDeps 不设这些变量,只导出 Boost::system 这样的 IMPORTED TARGET。硬写 ${Boost_LIBRARIES} 会报未定义变量错误。
必须用现代 CMake 的 target 形式:
target_link_libraries(main PRIVATE fmt::fmt OpenSSL::SSL Boost::system)
- 库名前缀(如
fmt::)来自cmake_file_name和cmake_target_name配置,不是随便写的 - 如果链接静态库且依赖传递了头文件,
PRIVATE就够;若需暴露给下游 target,改用PUBLIC - 别混用:不能
find_package(fmt CONFIG)却写target_link_libraries(main fmt)—— 缺少::会链接失败
conanfile.py / conanfile.txt 里要对得上 CMake 名
你写 find_package(OpenSSL CONFIG),Conan 就得真能生成 OpenSSLConfig.cmake。这取决于依赖包自身是否声明了 cmake_file_name 和 cmake_target_name。官方 Conan Center 的 openssl 包确实这么做了,但你自己打包的库可能没配。
自查要点:
- 运行
conan list "openssl/*" --remote conancenter看它是否带cmake_file_name="OpenSSL" - 自己写
conanfile.py时,在package_info()或set_property()里显式设置:self.cpp_info.set_property("cmake_file_name", "OpenSSL") - 如果漏了,
find_package(OpenSSL)会报Could not find a package configuration file provided by "OpenSSL"
include_directories 不需要手动写
有人习惯在 find_package() 后补一句 include_directories(${fmt_INCLUDE_DIRS}),这是过时做法。Conan 2.x 通过 CMakeDeps 注入的是 IMPORTED TARGET,其 INTERFACE_INCLUDE_DIRECTORIES 属性已自动生效。
只要 target_link_libraries(main PRIVATE fmt::fmt) 正确,头文件路径就自动加入编译命令。多写 include_directories() 不仅冗余,还可能引发重复包含或路径冲突。
真正容易被忽略的是:CMake cache 里残留旧版 FindXXX.cmake 或环境变量 CMAKE_MODULE_PATH 干扰,建议每次换 Conan 版本后清空 build/ 目录重来。











