conan install 必须在 conanfile.txt 或 conanfile.py 所在目录执行，而非项目根目录或 build 目录；常见错误是路径错位导致“no conanfile found”，正确做法是先 cd 进该目录再运行 conan install . --build=missing。
conan install 必须在 conanfile 所在目录执行
很多人卡在第一步：conan install 报错 No conanfile.py or conanfile.txt found。根本原因是命令没在声明依赖的目录下运行——不是项目根目录，也不是 build/ 目录，而是放了 conanfile.txt 或 conanfile.py 的那个目录。
常见错误场景：
- 把
conanfile.txt放在src/里，却在项目顶层执行conan install . - 用
conan install ./src，但没先cd ./src，导致 Conan 无法识别当前工作区 - 误以为 CMake 构建目录（如
build/）是“安装点”，跑去那里跑命令，结果找不到 recipe
正确做法：确认 conanfile.txt 存在后，cd 进该目录，再执行 conan install . --build=missing。
CMake 中必须禁用系统 Find 模块，只认 Conan 生成的配置
即使 conan install 成功生成了 generators/ 下的 fmt-config.cmake，CMake 仍可能优先加载系统自带的 Findfmt.cmake（比如 Ubuntu 的 /usr/share/cmake-3.x/Modules/Findfmt.cmake），导致链接到系统旧版库、头文件路径错乱或 find_package(fmt REQUIRED) 意外成功但实际没用 Conan 包。
解决方式是在 CMakeLists.txt 开头加一行强制屏蔽：
set(CMAKE_FIND_PACKAGE_PREFER_CONFIG ON)
并确保 find_package() 调用前已引入 Conan toolchain：
- 用
CMakeToolchain生成器时，CMake 命令需带-DCMAKE_TOOLCHAIN_FILE=generators/conan_toolchain.cmake - 不要手动
include(${CMAKE_BINARY_DIR}/conanbuildinfo.cmake)——那是 Conan 1.x 的老写法，Conan 2.x 不再生成该文件 -
find_package()必须出现在project()之后、add_executable()之前
本地缓存 ≠ 本地仓库，二进制包默认存在 ~/.conan2
Conan 不会把下载的二进制包复制到你项目里，而是统一存进本地缓存（默认 ~/.conan2），所有项目共享。这意味着：
- 删掉项目目录不影响已下载的包，下次
conan install会直接复用 - 不同项目若用了相同依赖+相同 profile（如
os=Linux,compiler=gcc），会命中同一份二进制，省时间 - 但这也带来风险：手动改
~/.conan2下的包内容会导致所有项目构建异常，不建议直接编辑 - 如需真正“本地化”（比如离线交付），得用
conan cache save导出为 tarball，或用conan create把自己写的库打成本地包
conanfile.py 里 package() 方法漏写 self.copy 就等于没打包
如果你用 conan create 发布自己的库（比如一个封装了硬件驱动的 mydriver/1.0），最常踩的坑是：编译通过了，但下游项目 find_package(mydriver) 找不到头文件或 mydriver::core target。
根本原因几乎全是 package(self) 方法里没调用 self.copy 显式声明要导出什么：
- 头文件必须放进
include/子目录：self.copy("*.h", dst="include", src="src/include") - 静态库要进
lib/：self.copy("*.a", dst="lib", src="build/lib") - 动态库进
bin/（Windows）或lib/（Linux/macOS），取决于 ABI 约定 - 漏掉
self.copy→ Conan 打包后目录为空 →find_package()失败，报Could not find a package configuration file
这个逻辑不靠 CMakeLists.txt 里的 install()，只靠 conanfile.py 中的 package()。哪怕 CMake 正确 install 了文件，Conan 也不会自动抓取。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
