cmaketoolchain是必需项而非可选项，因其直接控制编译器路径、c++标准版本、pic设置等底层行为；缺失会导致abi不一致、链接失败或运行时崩溃。
为什么 CMakeToolchain 不是可选项，而是必须显式启用
CMakeToolchain 生成的 conan_toolchain.cmake 文件不是“锦上添花”，它直接控制编译器路径、CMAKE_CXX_STANDARD、CMAKE_POSITION_INDEPENDENT_CODE、std::filesystem 是否启用等底层行为。漏掉它，哪怕 find_package() 成功了，也可能因 ABI 不一致或标准版本错位导致链接失败或运行时崩溃。
常见错误现象包括：
-
undefined reference to `std::filesystem::...'（C++17 标准启用了但 toolchain 没传给 CMake） - 交叉编译时仍调用宿主机
g++（profile 中设了CC=aarch64-linux-gnu-gcc，但没通过 toolchain 注入） - 启用
-fPIC失败，静态库无法被动态链接（fPIC=True选项只在 toolchain 中生效）
conanfile.txt 中必须写全 CMakeToolchain + CMakeDeps
只写 CMakeToolchain 不行，只写 CMakeDeps 也不行——二者职责分离，缺一不可：
-
CMakeDeps：生成fmt-config.cmake这类文件，让find_package(fmt CONFIG)能定位头文件和库路径 -
CMakeToolchain：生成conan_toolchain.cmake，覆盖 CMake 默认的编译器判断逻辑，强制使用 profile 或 conanfile 中声明的设置
正确写法（conanfile.txt）：
[requires] fmt/10.2.1 [generators] CMakeDeps CMakeToolchain [layout] cmake_layout
注意：[layout] cmake_layout 不是可选装饰，它确保 conan_toolchain.cmake 被生成到 build/generators/ 下，且路径与 CMake 构建目录对齐；不加它，include() 会找不到文件。
在 CMakeLists.txt 中 include 的顺序和位置不能错
include(${CMAKE_BINARY_DIR}/conan_toolchain.cmake) 必须放在 project() 之后、任何 add_executable() 或 find_package() 之前。否则 CMake 会先按默认规则初始化项目属性（比如误判为 C++14），后续再 include toolchain 也晚了。
典型错误写法：
cmake_minimum_required(VERSION 3.23)
project(myapp LANGUAGES CXX)
<h1>❌ 错：这里还没 include toolchain，CMAKE_CXX_STANDARD 已被设为默认值（通常是 14）</h1><p>find_package(fmt REQUIRED)</p><p>include(${CMAKE_BINARY_DIR}/conan_toolchain.cmake) # 太迟了</p>
正确写法：
cmake_minimum_required(VERSION 3.23)
project(myapp LANGUAGES CXX)
<h1>✅ 对：toolchain 必须最先加载，覆盖所有默认设定</h1><p>include(${CMAKE_BINARY_DIR}/conan_toolchain.cmake)</p><p>find_package(fmt REQUIRED)
add_executable(main main.cpp)
target_link_libraries(main PRIVATE fmt::fmt)</p>
profile 和命令行参数冲突时，CMakeToolchain 听谁的
CMakeToolchain 最终生效的设置，是 profile + 命令行 -s/-o + conanfile 中 settings/options 三者 merge 后的结果，但有明确优先级：
- 命令行
-s compiler.version=12> profile 中的compiler.version=11 - conanfile.py 中
self.settings.compiler.version = "13"> 命令行（仅限 conanfile.py；conanfile.txt不支持运行时 override） -
-o *:shared=True会覆盖 profile 和 conanfile 中对所有包的 shared 设置
关键点：CMakeToolchain 不会“猜测”你想要什么，它只忠实地把最终合并后的 settings 映射成 CMake 变量。比如 profile 写了 compiler.cppstd=20，但你执行 conan install . -s compiler.cppstd=17，那么生成的 toolchain 就会设 CMAKE_CXX_STANDARD 17——不会报错，也不会警告。
容易被忽略的是：CMakeToolchain 不处理依赖之间的 ABI 兼容性校验，它只管“本机编译设置”。如果你的 profile 是 libstdc++11，但某个依赖 recipe 强制用了 libc++，CMakeToolchain 照样生成，链接阶段才会暴露问题。
