Conan 2.x + CMake 实现“声明即下载”的前提是 conan install 必须在 cmake configure 前执行，且 --output-folder、CMAKE_BINARY_DIR、settings 三者严格对齐；否则 find_package() 将找不到库。
Conan 2.x + CMake 的组合能真正实现“声明即下载”，但前提是 conan install 必须在 cmake configure 之前执行，且生成路径、settings、toolchain 三者必须严格对齐——漏掉任意一环都会导致 find_package() 找不到库。
conan install 命令必须带 --output-folder 且与 CMAKE_BINARY_DIR 一致
Conan 不会自动把生成的 conan_toolchain.cmake 和 fmt-config.cmake 放进 CMake 默认搜索路径。你得显式指定输出目录，并在 CMakeLists.txt 中用 include() 加载它。
-
conan install . --output-folder=build --build=missing是最简安全写法；build目录需与后续cmake -B build的构建目录完全相同 - 如果用
-if（install-folder）参数，生成文件会散落在子目录里（如build/Release/generators/），CMake 就找不到conan_toolchain.cmake - 不加
--output-folder时，Conan 默认输出到当前目录，而 CMake 通常不从源码根目录加载 toolchain，容易静默失败
CMakeLists.txt 中的 include() 路径不能硬编码
很多教程写 include(${CMAKE_CURRENT_LIST_DIR}/build/generators/conan_toolchain.cmake)，这会导致跨机器或 CI 失败——因为 build 目录名可能被用户自定义（如 cmake -B mybuild）。
- 正确做法是依赖
CMAKE_BINARY_DIR：include(${CMAKE_BINARY_DIR}/conan_toolchain.cmake) -
CMakeDeps生成的*-config.cmake文件默认也放在${CMAKE_BINARY_DIR}下，所以find_package(fmt REQUIRED CONFIG)才能命中 - 若用了
CMakeToolchain但没在 CMakeLists.txt 开头就include，C++ 标准、编译器标志等设置会被忽略，导致链接失败或 ABI 不兼容
settings 必须和实际编译环境匹配，否则二进制不兼容
Conan 下载的二进制包是按 os/compiler/version/arch/build_type 精确打标签的。你在 conan install 里漏掉 -s compiler.libcxx，哪怕只用头文件库（如 fmt），也可能因 stdlib ABI 不一致导致链接时报 undefined reference。
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
立即学习“C++免费学习笔记（深入）”；
- Linux GCC 用户务必加：
-s compiler.libcxx=libstdc++11（GCC 5+）或libstdc++（旧版） - macOS Clang 用户加：
-s compiler.libcxx=libc++ - Windows MSVC 用户注意
-s compiler.runtime：动态链接用dynamic，静态用static，必须和你的 CMakeset(CMAKE_MSVC_RUNTIME_LIBRARY ...)一致 - 不加 settings 参数时，Conan 会按当前 Python 进程推测环境，但不可靠——CI 环境尤其容易出错
为什么 conanfile.py 比 conanfile.txt 更可靠
conanfile.txt 是纯声明式，无法做条件逻辑；而 conanfile.py 可以在 generate() 阶段动态控制 toolchain 内容，比如禁用某些编译器警告、注入自定义宏，还能在 requirements() 里根据 self.settings.os 切换依赖版本。
- 例如：Linux 下用
spdlog/1.13.0，Windows 下用spdlog/1.12.0（因新版依赖 Windows SDK 10.0.22621+） -
CMakeToolchain在conanfile.py中可调用tc.variables["CMAKE_CXX_STANDARD"] = "17"，避免 CMakeLists.txt 里重复设置 - 如果你的项目要支持
RelWithDebInfo构建类型，conanfile.txt无法声明该 setting，只能靠conanfile.py显式列出settings = "os", "compiler", "build_type", "arch"
最常被忽略的一点：Conan 生成的 conan_toolchain.cmake 会覆盖 CMake 的默认 CMAKE_CXX_FLAGS，包括 -O3 或 -g。如果你在 CMakeLists.txt 里后设 set(CMAKE_CXX_FLAGS ...)，它会被 toolchain 重置——所有编译选项必须在 generate() 阶段通过 CMakeToolchain 注入，而不是靠 CMake 自身变量。
