Conan 和 CMake 联动时，Debug 和 Release 不是“自动对齐”的——你必须显式对齐 build_type（Conan 侧）和 CMAKE_BUILD_TYPE（CMake 侧），否则依赖库和主项目会用错配置，轻则链接失败，重则运行时崩溃。
conan install 必须带 --settings build_type=xxx
Conan 默认 profile 是 Release，如果你不显式指定，conan install 拿到的头文件、库路径、编译定义全按 Release 处理。而 CMake 若用 -DCMAKE_BUILD_TYPE=Debug 构建，就会出现：头文件里没定义 DEBUG 宏、链接的却是 msvcrtd.lib（Windows）或 libfoo_d.a（Linux），但 Conan 提供的库其实是 Release 版本。
- 正确做法：每次
conan install都要跟上构建类型，例如：conan install . --output-folder=build --build=missing --settings build_type=Debug - 错误写法：
conan install .（默认 Release）+cmake -DCMAKE_BUILD_TYPE=Debug ..→ 依赖和主工程脱节 - 多配置生成器（如 Visual Studio）例外：此时
build_type应设为None，靠--config Debug控制，Conan 2.1+ 支持conan install . --settings build_type=None并配合CMAKE_CONFIGURATION_TYPES
CMakeLists.txt 里不能只靠 CMAKE_BUILD_TYPE 判断
CMAKE_BUILD_TYPE 只在单配置生成器（Make/Ninja）下有效；在 VS/Xcode 中它为空，实际配置由 CMAKE_CONFIGURATION_TYPES 和构建时 --config 决定。如果你在 CMakeLists.txt 里写 if(${CMAKE_BUILD_TYPE} STREQUAL "Debug")，VS 用户永远进不去 Debug 分支。
- 安全写法：用
if(CMAKE_CONFIGURATION_TYPES)检查是否为多配置，再结合MSVC或CMAKE_XCODE_ATTRIBUTE_CONFIGURATION_BUILD_DIR做适配 - 更通用的做法：让 Conan 的
CMakeDeps生成器输出的conandeps.cmake自动注入CONAN_DEBUG这类变量，然后在 CMake 中判断if(DEFINED CONAN_DEBUG) - 别硬编码
set(CMAKE_BUILD_TYPE "Debug")—— 这会覆盖用户命令行传入的值，且在 VS 下直接失效
Debug 后缀和库名差异必须由 Conan 传递，不能靠 CMake 猜
Windows 下，foo.lib 和 food.lib 是两套 ABI 不兼容的库；Linux 下常见 libfoo.so 和 libfoo_d.so。CMake 本身不会根据 build_type 自动切换库名，它只认你 target_link_libraries() 里写的那个名字。
- 正确路径：Conan 的
CMakeDeps生成器会为每个依赖生成xxx-release-x86_64-data.cmake和xxx-debug-x86_64-data.cmake，里面已包含正确的INTERFACE_LINK_LIBRARIES路径和后缀 - 手动写
debug msvcrtd.lib optimized msvcrt.lib是危险的——你得确保 Conan 提供的库真有对应后缀，且路径一致；一旦 Conan profile 改了compiler.runtime，这个写法就断掉 - 验证方法：
grep -r "msvcrtd" build/，看CMakeDeps生成的文件里是否含 Debug 对应的库名
容易被忽略的点：RelWithDebInfo 和 MinSizeRel 的陷阱
很多人以为只要不是 Debug 就是 Release，但 Conan 和 CMake 都支持 RelWithDebInfo 和 MinSizeRel。如果 Conan profile 设了 build_type=RelWithDebInfo，但 CMake 仍用 Release 构建，CMakeDeps 会找不到匹配的配置文件，导致 find_package() 失败或退化为空依赖。
- Conan 2.x 不允许
build_type值自由拼写，只接受Debug/Release/RelWithDebInfo/MinSizeRel四个严格大小写匹配的字符串 - 执行
conan profile show default看当前 profile 的build_type值，别想当然认为它是Release - CI 脚本里尤其要注意：不同平台可能用不同 profile，
conan install命令必须明确指定--profile:build和--profile:host，避免 host profile 的build_type被 build profile 覆盖
