c++oding="utf-8" ?>
conan能绕开系统包管理器的abi锁死问题,通过将编译器、标准库、架构等全维度纳入settings(如-s compiler=clang -s compiler.libcxx=libc++),自动匹配或重建对应abi兼容的二进制,避免因gcc/clang混用导致的undefined reference等链接失败。

Conan 能绕开系统包管理器的 ABI 锁死问题
Linux 上用 apt install libfmt-dev、macOS 用 brew install fmt,看似方便,但实际埋了雷:这些包由系统维护,编译器版本、C++ 标准库(libstdc++ vs libc++)、调试/发布模式都不可控。一旦你项目要求 clang-16 + libc++ + C++20,而系统仓库只提供 gcc-11 + libstdc++ + C++17 的二进制,链接就直接失败。
Conan 把「编译器+标准库+架构+构建类型」全写进 settings,比如 -s compiler=clang -s compiler.version=16 -s compiler.libcxx=libc++,它会自动匹配或重建对应二进制。你换平台、换编译器,只要 conan install 命令里 settings 对得上,依赖就能链得通。
常见错误现象:undefined reference to `fmt::v8::format(...) —— 这不是代码写错了,是链接时用了 GCC 编译的 fmt 动态库,却用 Clang 编译主程序,ABI 不兼容。
conanfile.txt 比手写 find_package 更可靠
CMake 的 find_package(fmt) 依赖环境变量、系统路径、CMAKE_PREFIX_PATH,跨平台时经常找不到——Windows 没有 /usr/include,macOS 的 Homebrew 路径又和 Linux 不同。而 Conan 生成的 CMakeDeps 会输出明确的 fmt-config.cmake,路径固定在构建目录下,CMake 只需 include() 就能加载,不查环境、不猜路径。
实操建议:
- 必须把
CMakeDeps和CMakeToolchain同时写进conanfile.txt的[generators],缺一不可 -
CMakeToolchain会覆盖 CMake 默认的编译器判断逻辑,避免因 host 系统编译器干扰 target 构建 - 不要在
CMakeLists.txt里硬编码find_package(fmt 10.2.1 EXACT),让 Conan 生成的 config 文件自己做版本校验
私有库和 CI/CD 集成不需要改构建脚本
企业内部有自研日志库 mylogger/2.1.0,想让它像 fmt 一样被所有项目引用?Conan 允许你搭私有仓库(比如 Artifactory),然后只改一行:conan remote add mycorp https://artifactory.mycorp.com/conan。后续 conan install 就自动优先从私有源拉取,没命中再 fallback 到 conancenter。
这对 CI 很关键:Linux CI 用 GCC、Windows CI 用 MSVC、macOS CI 用 Clang,三套流水线共用同一份 conanfile.txt,不用为每个平台维护不同 find_package 路径或 add_subdirectory 逻辑。
容易踩的坑:
- 忘记运行
conan remote enable mycorp,导致私有包始终不被查询 - CI 中未配置
--build=missing,遇到私有库没有预编译二进制时静默跳过,最后链接报错 - 本地开发时用了
conan create测试包,但没conan upload到私有源,CI 拉不到
交叉编译时 Conan 比 vcpkg 更轻量可控
vcpkg 要求提前预装全部 triplet,且默认强制静态链接;Conan 的 settings 是自由组合的,比如嵌入式 ARM64 + GCC 12 + no STL + C++17,你可以只声明需要的部分:-s arch=armv8 -s compiler=gcc -s compiler.version=12 -s compiler.libcxx=none,它不会给你塞一堆用不上的依赖。
性能影响很小:Conan 2.x 默认启用二进制缓存,相同 settings 下重复构建不会重编第三方库;而 vcpkg 每次 vcpkg install 都可能触发冗余检查。
注意一点:Conan 不自动处理工具链文件(如 aarch64-linux-gnu-gcc 路径),你需要自己在 CMakeToolchain 里补上 tools.cmake.cxx 设置,否则 CMake 找不到交叉编译器。
C++免费学习笔记(深入):立即使用
在学习笔记中,你将探索 C++ 的入门与实战技巧!











