
在C++项目中,手动管理第三方依赖(如Boost、Openssl、fmt等)常常带来版本冲突、编译环境不一致和跨平台兼容问题。Conan 是一个现代 C++ 包管理器,能有效解决这些痛点。它支持跨平台、自定义构建流程,并与主流构建系统(如 CMake)无缝集成。
安装与初始化 Conan
Conan 基于 python 开发,使用 pip 安装最简单:
pip install conan
首次运行后,Conan 会自动创建本地缓存目录(通常位于 ~/.conan 或 C:UsersYourName.conan)。建议升级到 Conan 2.x 版本以获得更好性能和安全性。
创建 conanfile.txt 描述依赖
在项目根目录下创建 conanfile.txt,声明所需包及其版本:
立即学习“C++免费学习笔记(深入)”;
[requires]
fmt/10.1.1
nlohmann_json/3.11.2
openssl/3.2.0
[generators]
CMakeDeps
CMakeToolchain
其中:
- [requires] 列出项目依赖的包名和版本
- [generators] 指定生成器,用于与 CMake 集成。CMakeDeps 生成 FindPackage 文件,CMakeToolchain 提供工具链配置
配置并安装依赖
在构建目录中运行以下命令,Conan 会解析依赖、下载或构建二进制包:
conan install .. –output-folder=build –build=missing –generator cmake
说明:
- –output-folder=build:指定输出路径为 build 目录
- –build=missing:若远程无匹配二进制包,则本地构建
- –generator cmake:生成 CMake 兼容文件(Conan 2.x 中通常通过 [generators] 自动处理)
执行后,Conan 会在 build/ 目录生成诸如 fmt-config.cmake 等文件,供 CMake 使用。
在 CMakeLists.txt 中使用依赖
确保 CMake 能找到 Conan 生成的配置文件:
cmake_minimum_required(VERSION 3.15)
project(MyProject)
导入 Conan 生成的工具链和依赖
include(${CMAKE_BINARY_DIR}/conan_toolchain.cmake)
include(${CMAKE_BINARY_DIR}/conan_deps.cmake)
add_executable(main main.cpp)
自动链接所有依赖
target_link_libraries(main private fmt::fmt nlohmann_json::nlohmann_json)
注意:具体 include 的文件名可能因 Conan 版本略有不同,建议查看 build 目录中的实际生成文件。
高级用法:自定义 profile 与远程仓库
Conan 支持 profile 来精确控制构建环境,例如指定编译器、标准版本等:
# 创建名为 gcc11 的 profile
conan profile new gcc11 –detect
conan profile update settings.compiler.libcxx=libstdc++11 gcc11
使用 profile 安装依赖:
conan install .. –profile=gcc11 –output-folder=build –build=missing
你也可以添加私有仓库:
conan remote add myrepo https://my-conan-server.com
基本上就这些。Conan 让 C++ 项目的依赖管理变得清晰可控,尤其适合团队协作和持续集成场景。配合 CMake 使用,基本可以实现“克隆即构建”的开发体验。