conan安装后conan --version报command not found主因是path未生效：windows需重启终端或手动加scripts路径，macos/linux需将~/.local/bin加入shell配置并重载；用conanfile.txt声明依赖时需配置[requires]和[generators]，运行conan install --build=missing生成cmake所需文件；find_package(fmt)失败因conan生成config模式文件，须用find_package(fmt config required)并确保cmake_prefix_path包含deps目录；跨平台构建卡住常因无匹配预编译包而触发本地编译，应优先查可用二进制、用--build=never或调整settings避免编译。
Conan 安装后为什么 conan --version 报 command not found？
多数情况是 PATH 没生效。Windows 上用 Chocolatey 或 Scoop 安装后需重启终端；macOS/Linux 用 pip 安装时，conan 可能落在 ~/.local/bin，而该路径未被 shell 加载。
- 检查安装位置：
python -m pip show conan→ 看Location和Files行 - Linux/macOS：把
export PATH="$HOME/.local/bin:$PATH"加进~/.bashrc或~/.zshrc，再执行source ~/.zshrc - Windows：确认安装时勾选了 “Add Conan to PATH”，否则手动把
C:\Users\{user}\AppData\Roaming\Python\PythonXX\Scripts加入系统环境变量
如何用 conanfile.txt 声明依赖并生成 conanbuildinfo.cmake？
这是最轻量的集成方式，适合已有 CMake 项目的快速接入。Conan 不接管构建，只负责下载 + 生成 CMake 可读的配置文件。
- 在项目根目录建
conanfile.txt，内容示例：
[requires] fmt/10.2.1 spdlog/1.13.0 [generators] CMakeDeps CMakeToolchain
- 运行：
conan install . --build=missing --settings compiler.cppstd=17 - 注意：
--build=missing是关键，否则遇到预编译包不匹配（如 macOS M1 vs Intel）会直接报错退出 - 生成的
conan_toolchain.cmake和xxx-deps.cmake文件默认输出到当前目录，CMake 需显式加载：cmake -DCMAKE_TOOLCHAIN_FILE=conan_toolchain.cmake ...
为什么 CMakeLists.txt 里 find_package(fmt) 找不到，但 find_package(fmt CONFIG) 可以？
因为 Conan 的 CMakeDeps 生成的是 CONFIG 模式文件（即 fmtConfig.cmake），它不走 CMake 默认的 FindXXX.cmake 路径搜索逻辑。
- 必须用
find_package(fmt CONFIG REQUIRED)，且确保CMAKE_PREFIX_PATH包含 Conan 生成的 deps 目录（通常由conan_toolchain.cmake自动注入） - 如果仍失败，检查
conan install输出末尾是否提示Generated xxx-config.cmake，没有说明CMakeDeps未生效或包本身不提供 cmake targets - 旧项目若坚持用
find_package(fmt)，可临时加一层兼容：include(${CMAKE_BINARY_DIR}/conanbuildinfo.cmake)+conan_basic_setup()（仅限 legacyconanbuildinfo.cmake方式）
跨平台构建时 conan install 总卡在某个包的 build 阶段
根本原因是 Conan 默认按 host 设置（OS/arch/compiler）匹配预编译二进制，一旦官方仓库没提供对应组合（比如 Windows + clang + static CRT），就会 fallback 到本地编译——而很多 C++ 包（如 OpenSSL、Boost）在非标准环境下编译失败率极高。
立即学习“C++免费学习笔记（深入）”；
- 先查可用二进制：
conan search fmt/10.2.1 -r conancenter，看输出中是否有匹配你--settings的行 - 避免编译：加
--build=never强制只用二进制；或指定更通用的 settings，例如把compiler.runtime从MT改成MD（Windows 动态链接 CRT） - 真要编译：确保已安装对应工具链（如 MinGW 工具链需提前配好
CONAN_CMAKE_GENERATOR和CONAN_CMAKE_TOOLCHAIN_FILE）
真正麻烦的从来不是“怎么让 Conan 下载”，而是“怎么让它别自己编译”。每个包的编译脚本质量参差不齐，尤其涉及汇编或平台特有 ABI 时，本地编译极易失败。建议优先锁定已验证的二进制版本，再通过 conan lock 固化依赖图。
