必须显式对齐cmake的build_type：conan install需用-s build_type=debug指定，且cmake配置须同步加-dcmake_build_type=debug；windows+msvc例外，依赖--config debug与profile中build_type=debug双重对齐。
conan install 时必须显式对齐 CMake 的 build_type
Conan 不会自动把 build_type=Debug 映射成 CMake 的 -DCMAKE_BUILD_TYPE=Debug，尤其在 Makefiles/Ninja 这类单配置生成器下，漏掉这步会导致所有依赖按 Release 编译，但你的主项目却在 Debug 下链接 —— 最终出现符号不匹配、断点失效、assert 被优化掉等典型问题。
正确做法是：运行 conan install 时，用 -s build_type=Debug（或 Release）明确指定，并确保它和后续 CMake 配置一致：
conan install .. --build=missing -s build_type=Debug -s compiler=gcc -s compiler.version=12- 接着 CMake 配置必须带
-DCMAKE_BUILD_TYPE=Debug，否则 Conan 生成的conan_toolchain.cmake里set(CMAKE_BUILD_TYPE "Debug")不会被触发 - Windows + MSVC 是例外：CMake 多配置生成器（如 Visual Studio）不依赖
CMAKE_BUILD_TYPE，此时要靠--config Debug和 profile 中build_type=Debug双重对齐
CMakeToolchain 生成的 toolchain.cmake 文件里哪些变量真正影响编译器行为
CMakeToolchain 生成的 conan_toolchain.cmake 不是“全量覆盖”，它只写入 Conan 认为需要强制统一的部分。真正决定编译器行为的关键变量有三个：
-
CMAKE_C_COMPILER和CMAKE_CXX_COMPILER：由 profile 中[buildenv]的CC/CXX或[conf]的tools.cmake.cmaketoolchain:user_toolchain控制，不是靠compiler=xxx设置项自动推导 -
CMAKE_SYSROOT：对应 profile 中tools.build:sysroot，缺失会导致头文件路径错乱、__linux__宏未定义等问题 -
CMAKE_SYSTEM_NAME/CMAKE_SYSTEM_PROCESSOR：由tools.cmake.cmaketoolchain:system_name和system_processor控制，影响 CMake 内置的平台检测逻辑（比如是否启用-mfloat-abi=hard）
注意：compiler.version 和 compiler.libcxx 这类 setting 不会直接写进 toolchain，它们只用于二进制包匹配和 ABI 兼容性检查。
profile 里 [buildenv] 和 [conf] 混用时的优先级陷阱
当同时在 profile 中设置 [buildenv] CC=/path/to/arm-gcc 和 [conf] tools.cmake.cmaketoolchain:user_toolchain=/path/toolchain.cmake，Conan 会忽略 [buildenv] 的编译器变量 —— 因为 user_toolchain 模式下，所有编译器路径、标志都由外部 CMake 文件接管，Conan 只负责把该文件路径传给 CMake。
常见误操作：
- 以为写了
CC=xxx就能覆盖user_toolchain里的设置 → 实际无效 - 在
user_toolchain.cmake里没显式 setCMAKE_C_COMPILER，结果 CMake 回退到系统默认 gcc → 交叉编译失败 - 用
[buildenv]设置了PKG_CONFIG_PATH，但忘了同步在user_toolchain.cmake里加set(ENV{PKG_CONFIG_PATH} "...")→find_package()找不到 sysroot 下的库
为什么 CMakeLists.txt 里必须 include conan_toolchain.cmake 在 project() 之后
include(${CMAKE_BINARY_DIR}/conan_toolchain.cmake) 必须放在 project() 之后，否则 CMake 会报错 CMAKE_CXX_STANDARD is set to invalid value 或静默忽略 toolchain 中的 set(CMAKE_CXX_STANDARD 17) 等关键设置。
根本原因：CMake 在 project() 执行时会初始化语言标准、编译器识别、内置变量等上下文；conan_toolchain.cmake 依赖这些已初始化的状态才能安全覆盖。提前 include 相当于在真空里改参数，CMake 不认账。
顺带一提：如果你用的是 cmake-conan v2 的 conan_provider.cmake，它内部已处理好顺序，但手动 include 时这个顺序必须自己盯紧。
