Conan是C/C++的分布式包管理器,支持跨平台与私有仓库,通过conanfile.txt声明依赖,结合CMake实现自动化构建,简化第三方库的版本管理与编译流程。

在C++项目中管理第三方依赖一直是个痛点,尤其跨平台开发时更显复杂。Conan 是一个现代的、分布式的 C++ 包管理器,支持跨平台(Windows、Linux、macOS 等),能自动处理依赖下载、编译、链接和版本管理,极大简化了构建流程。
什么是 Conan?
Conan 全称 Conan: C/C++ Package Manager,由 JFrog 开发并维护,不是基于系统包管理器(如 apt 或 brew),而是为 C++ 量身打造。它不绑定特定构建系统(支持 CMake、Meson、MSBuild 等),也不依赖中央仓库,允许私有和公有仓库并存。
核心特性包括:
- 支持源码构建与二进制分发
- 灵活的配置:不同编译器、标准库、架构、调试/发布模式
- 依赖图自动解析与冲突检测
- 可集成 CI/CD 与 Artifactory 私有仓库
安装与基础配置
确保系统已安装 Python(推荐 3.7+),然后通过 pip 安装 Conan:
立即学习“C++免费学习笔记(深入)”;
pip install conan首次运行会初始化缓存目录(通常位于 ~/.conan 或 C:\Users\YourName\.conan)。你可以通过以下命令检查版本和环境:
conan --version如果你使用的是较新版本(Conan 2.x),部分命令语法有变化。本文以 Conan 2.x 为主(2024年后主流)。
在项目中使用 Conan 添加依赖
假设你要创建一个使用 fmt 库(格式化字符串)的 C++ 项目。
1. 创建 conanfile.txt在项目根目录新建 conanfile.txt,声明依赖和需要导出的内容:
[requires]fmt/10.2.1
[generators]
CMakeDeps
CMakeToolchain
这里指定了:
- fmt/10.2.1:从 Conan Center 获取 fmt 库的 10.2.1 版本
- CMakeDeps:生成供 CMake 使用的依赖配置文件(xxxConfig.cmake)
- CMakeToolchain:生成工具链文件,确保编译设置一致
在构建目录中执行:
mkdir build && cd buildconan install .. --build=missing -s compiler=gcc -s compiler.version=11 -s build_type=Release
说明:
- --build=missing:若无预编译二进制包,则从源码构建
- -s 指定设置(settings),确保与你的构建环境匹配
- 执行后会在当前目录生成 CMake 所需的 .cmake 文件
使用 Conan 提供的信息链接库:
cmake_minimum_required(VERSION 3.15)project(myapp)
find_package(fmt REQUIRED CONFIG)
add_executable(main main.cpp)
target_link_libraries(main PRIVATE fmt::fmt)
注意:Conan 2.x 推荐使用 find_package + target_link_libraries 的方式,更加现代且可靠。
4. 构建项目继续在 build 目录执行:
cmake .. -DCMAKE_TOOLCHAIN_FILE=conan_toolchain.cmakecmake --build .
Conan 已经生成了 toolchain 文件,CMake 会正确找到依赖路径和编译选项。
进阶:自定义 profile 和多配置管理
频繁输入编译器参数很麻烦。Conan 支持 profile 来保存构建配置。
创建 profile 文件: conan profile new default --detectconan profile show default
你也可以新建一个 release-gcc11.profile:
[settings]os=Linux
arch=x86_64
compiler=gcc
compiler.version=11
build_type=Release
使用时指定:
conan install .. --profile ./release-gcc11.profile --build=missing这样就能轻松切换不同平台或构建模式。
私有包与团队协作
公司项目常需私有库。你可以用 JFrog Artifactory 或 Conan Server 搭建私有仓库。
添加远程仓库:
conan remote add mycompany https://artifactory.mycompany.com/conan上传包示例:
- 编写 conanfile.py(比 .txt 更强大,支持逻辑判断、源码获取、编译脚本等)
- 运行 conan create . user/channel 构建本地包
- 运行 conan upload "pkg_name" --remote=mycompany 推送到私有仓库
团队成员只需添加该远程,即可透明使用内部组件。
基本上就这些。Conan 让 C++ 项目的依赖不再“手动下载解压改路径”,真正实现“一键拉取,自动构建”。配合 CMake 和 CI 脚本,跨平台开发效率大幅提升。











