Conan能解决头文件找不到、链接失败、编译结果不一致问题，前提是conan install参数与CMakeLists.txt路径严格匹配；必须用[requires]和[generators]区块且顺序不可颠倒，[requires]写fmt/10.2.1全名，[generators]需同时含CMakeDeps和CMakeToolchain；项目用cmake_layout时需配--output-folder=build，并在CMakeLists.txt开头include(${CMAKE_BINARY_DIR}/generators/conan_toolchain.cmake)；find_package(fmt CONFIG REQUIRED)失败主因是CMakeDeps未生效或路径错误，且须确保toolchain包含后才设置CMAKE_CXX_STANDARD。
Conan 能直接解决「头文件找不到、链接失败、不同机器编译结果不一致」这三类高频问题，前提是 conan install 的参数和 CMakeLists.txt 中的加载路径严格匹配——错一个就报 find_package(fmt CONFIG REQUIRED) called with no module path 这类错误。
conanfile.txt 怎么写才不会被 CMake 忽略
必须用 [requires] 和 [generators] 两个区块，且顺序不能颠倒；CMakeDeps 和 CMakeToolchain 是 Conan 2.x 唯一推荐组合，旧版 cmake_find_package 已弃用。
-
[requires]里写全名+版本，比如fmt/10.2.1，不是fmt或fmt@10.2.1 -
[generators]必须同时包含CMakeDeps和CMakeToolchain，少一个，CMake 就找不到find_package()所需的fmtConfig.cmake或编译器标志 - 如果项目结构是
src/main.cpp+build/目录，加一行[layout]：cmake_layout，否则生成的generators/路径会错位
CMakeLists.txt 中 include() 的路径怎么算对
不是硬写 include(conan_toolchain.cmake)，而是根据 conan install 的输出位置动态拼接。Conan 默认把生成文件放进 build/generators/，所以 CMake 必须从 build 目录运行，且 include() 要指向该目录下的文件。
- 在
CMakeLists.txt开头写：include(${CMAKE_BINARY_DIR}/generators/conan_toolchain.cmake)（不是${CMAKE_SOURCE_DIR}） - 执行
conan install时必须指定--output-folder=build，否则generators/不在你期望的位置 - 如果用了
cmake_layout，Conan 会自动按build/Release/generators/这类子目录组织，此时include()应改为：include(${CMAKE_BINARY_DIR}/generators/conan_toolchain.cmake)—— CMake 会自动识别当前构建类型子目录
conan install 命令漏了 -s 参数会导致链接失败
Conan 默认用 ~/.conan2/profiles/default，但这个 profile 很可能和你实际环境不一致：比如系统装的是 GCC 12，profile 却记成 GCC 11，或 compiler.libcxx 是 libstdc++11，而你代码用了 std::string_view（需要 libstdc++20）。
- 运行
conan profile show default看当前 profile 内容，重点核对：compiler.version、compiler.libcxx、os、arch - 显式传参比依赖 profile 更可靠：
conan install . --build=missing -s compiler=gcc -s compiler.version=12 -s compiler.libcxx=libstdc++20 - 交叉编译时必须用
--profile:host=xxx指定目标平台 profile，否则 Conan 会拿宿主机设置去拉包，导致 ABI 不兼容（比如 aarch64 包被当成 x86_64 链接）
find_package() 报 CONFIG 模式失败的常见原因
错误信息类似 By not providing "Findfmt.cmake" in CMAKE_MODULE_PATH，其实不是缺 Findxxx.cmake，而是没走 CONFIG 模式查找路径——根本原因是 CMakeDeps 没生效或路径不对。
- 确保
find_package(fmt CONFIG REQUIRED)中写了CONFIG，不写就 fallback 到旧式模块查找，必然失败 - 检查
build/generators/下是否存在fmt-config.cmake（注意是短横线，不是下划线）；不存在说明CMakeDeps没触发，大概率是conan install没在 conanfile.txt 所在目录执行 - 如果用了
add_subdirectory()引入子项目，子项目的find_package()会继承父项目的CMAKE_PREFIX_PATH，但 Conan 生成的路径默认只设给当前CMAKE_BINARY_DIR，需手动补：set(CMAKE_PREFIX_PATH ${CMAKE_BINARY_DIR}/generators ${CMAKE_PREFIX_PATH})
最容易被忽略的是：Conan 生成的 conan_toolchain.cmake 会覆盖 CMAKE_CXX_STANDARD，如果你在 CMakeLists.txt 里先 set 再 include toolchain，会被 toolchain 重置。正确顺序是：先 include()，再 set(CMAKE_CXX_STANDARD 17)。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
