conan_toolchain.cmake 必须在 project() 之后、任何 target 定义之前 include，否则编译器设置和 cmake_prefix_path 不生效，导致 find_package() 失败；正确顺序为 cmake_minimum_required → project → include(${cmake_binary_dir}/generators/conan_toolchain.cmake)。
conan_toolchain.cmake 必须在 project() 之后、任何 target 定义之前 include
这是最常出错的地方：CMake 要求工具链文件必须在 project() 执行后立即加载，否则编译器设置（如 CMAKE_CXX_STANDARD、CMAKE_SYSTEM_NAME）不会生效，后续 find_package() 可能因 ABI 不匹配而失败。
正确顺序是：
cmake_minimum_required()project()include(${CMAKE_CURRENT_LIST_DIR}/build/Release/generators/conan_toolchain.cmake)- 再设置
CMAKE_CXX_STANDARD或add_executable()
注意路径中的 Release 是 build type 名，若你用 Debug 构建，得改成 build/Debug/generators/...；更稳妥的做法是用变量代替：include(${CMAKE_BINARY_DIR}/generators/conan_toolchain.cmake)，前提是 conan install 时指定了 --output-folder=${CMAKE_BINARY_DIR}。
conan install 没生成 conan_toolchain.cmake？检查 generators 和 profile
如果 conan install . --build=missing 运行完，generators/ 目录下没有 conan_toolchain.cmake，大概率是 conanfile.txt 里漏写了 CMakeToolchain：
-
[generators]下必须显式列出CMakeToolchain（大小写敏感，不能写成cmaketoolchain） - 确保没混用旧版生成器（如
cmake_find_package），Conan 2.x 中它已被弃用 - profile 设置错误会导致生成器跳过——比如
compiler未指定，Conan 会报 warning 并不生成 toolchain - 运行
conan profile show default确认 profile 包含完整 compiler 信息（compiler.version、compiler.libcxx等）
交叉编译时 conan_toolchain.cmake 与 user_toolchain 冲突怎么办
当你的 profile 里同时配置了 [conf] tools.cmake.cmaketoolchain:user_toolchain=/path/to/toolchain.cmake 和 CMakeToolchain 生成器，Conan 会把两者合并：user_toolchain 的内容会被注入到生成的 conan_toolchain.cmake 开头，但不会覆盖。容易踩的坑是：
CMake 4.3.2 Windows x86_64 历史版本安装包，适合旧项目兼容、构建环境回退、CMakeLists.txt 迁移验证、Visual Studio/Ninja/Makefile 生成器测试和 C/C++ 项目维护。
- 手动在 CMakeLists.txt 里又
include(/path/to/toolchain.cmake)—— 导致重复设置CMAKE_C_COMPILER，CMake 报错 “CMAKE_C_COMPILER is set to a non-existent tool” - user_toolchain 里用了
set(CMAKE_SYSTEM_NAME ...)，而 Conan 生成的 toolchain 也设了同名变量，后者会覆盖前者（因为 include 顺序靠后） - 想让
CMAKE_SYSROOT生效，必须确保它在conan_toolchain.cmake中被定义为set(CMAKE_SYSROOT ... CACHE PATH "")，否则 CMake 不识别
验证方法：打开生成的 conan_toolchain.cmake，搜 CMAKE_C_COMPILER 和 CMAKE_SYSTEM_NAME，确认值是你期望的交叉工具链路径和目标系统名。
为什么 find_package(fmt CONFIG) 还是失败？可能 toolchain 没生效
find_package(fmt CONFIG) 失败常不是依赖没装，而是 conan_toolchain.cmake 未真正影响构建环境。典型现象：
- CMake 报错
Could not find a package configuration file provided by "fmt"，但fmt-config.cmake明明在generators/下 - 实际原因是
CMAKE_PREFIX_PATH没被 toolchain 正确设置，导致find_package()不去generators/目录找 - Conan 的
CMakeDeps生成器负责写fmt-config.cmake，但它依赖CMakeToolchain提供的CMAKE_PREFIX_PATH基础路径才能被发现 - 检查生成的
conan_toolchain.cmake是否包含类似set(CMAKE_PREFIX_PATH "${CMAKE_CURRENT_LIST_DIR}/generators" ${CMAKE_PREFIX_PATH})的语句
如果缺失，说明 conan install 时没传对参数，或 Conan 版本太老（低于 2.0.14）。强制刷新：删掉 build/ 和 conan.lock，重跑 conan install . --build=missing --output-folder=build。
toolchain 文件本质是 CMake 脚本，它不“自动生效”，只在被 include() 且位置正确时才起作用；很多问题根源不在 Conan，而在 CMakeLists.txt 里那一行 include() 的时机和路径写错了。
