conanfile.txt必须同时指定cmakedeps和cmaketoolchain;cmakelists.txt中需先include conan_toolchain.cmake再project();conan install须带--profile、--build=missing及-g参数;子目录不重复执行conan install。

conanfile.txt 里必须指定 CMakeDeps 和 CMakeToolchain
Conan 2.x 不再默认生成 conanbuildinfo.cmake,直接用 conan_basic_setup() 会失败。你得在 conanfile.txt 的 [generators] 段明确写上:
[generators] CMakeDeps CMakeToolchain
缺一不可:CMakeDeps 生成 xxx-config.cmake 文件供 find_package() 使用;CMakeToolchain 生成 conan_toolchain.cmake,统一控制编译器、标准库、构建类型等底层设置。如果只写一个,CMake 要么找不到包,要么用错 -std 或 -fPIC 等标志。
CMakeLists.txt 中的 include 顺序不能颠倒
必须先加载工具链,再调用 project(),否则 CMAKE_CXX_STANDARD 等变量会被覆盖。正确顺序是:
cmake_minimum_required(VERSION 3.15)
# 必须在 project() 之前
include(${CMAKE_BINARY_DIR}/conan_toolchain.cmake)
<p>project(MyApp LANGUAGES CXX)
set(CMAKE_CXX_STANDARD_REQUIRED ON)
set(CMAKE_CXX_EXTENSIONS OFF)</p><h1>再导入依赖配置</h1><p>include(${CMAKE_BINARY_DIR}/generators/conan_deps.cmake)</p><p>add_executable(app main.cpp)
find_package(fmt CONFIG REQUIRED)
target_link_libraries(app PRIVATE fmt::fmt)</p>
常见错误包括:include(conan_toolchain.cmake) 放在 project() 后面;或漏掉 include(conan_deps.cmake) 导致 find_package() 报 Could not find configuration file。
conan install 命令必须带 --profile 和 --build=missing
跨平台意味着不同系统/编译器组合需要各自独立的二进制包。仅靠 conan install .. 会默认用 host profile,很可能导致 Linux 上用 clang profile 构建失败,或 Windows 上链接 MSVC 库出错。
CMake 4.3.2 Windows x86_64 历史版本安装包,适合旧项目兼容、构建环境回退、CMakeLists.txt 迁移验证、Visual Studio/Ninja/Makefile 生成器测试和 C/C++ 项目维护。
-
--profile指向你预先配好的平台描述文件,比如~/.conan2/profiles/linux-gcc-11-release -
--build=missing强制补全本地缓存中缺失的二进制(尤其对自建包或新平台) - 必须加
--generator参数匹配 CMakeLists.txt 中的 generator,例如-g Ninja,否则CMakeToolchain生成的文件可能不兼容你的构建后端
典型命令:
conan install .. --profile linux-gcc-11-release --build=missing -g Ninja
子模块多时,避免在 subdirectory 里重复调用 conan install
Conan 管理的是整个项目的依赖图,不是每个 add_subdirectory() 子目录的局部依赖。你在根目录执行一次 conan install,生成的 conan_toolchain.cmake 和 conan_deps.cmake 就已覆盖全部 targets。
如果在子目录 CMakeLists.txt 里又写 include(.../conan_toolchain.cmake),CMake 会报 Variable is set to cache 冲突;若子目录单独跑 conan install,还会污染本地缓存或触发重复构建。
真正要做的只有两件事:
- 所有
find_package()都在根CMakeLists.txt或其include()的顶层脚本里完成 - 子目录只需用
target_link_libraries(mylib PRIVATE fmt::fmt),不关心 Conan 怎么来的
跨平台项目最易忽略的一点:CMakeToolchain 生成的 conan_toolchain.cmake 会硬编码 CMAKE_SYSTEM_NAME 和 CMAKE_SYSTEM_PROCESSOR,一旦你手动改了这些变量,整个工具链就失效——别动它。










