Conan 2.0 是现代化 C++ 包管理器,通过 conanfile.py 声明依赖(如 fmt/10.2.1),结合 CMakeDeps 生成器与 CMakeToolchain 实现依赖自动下载和构建集成,使用 conan install 安装并生成配置,支持多配置、跨平台管理,提升项目可维护性和构建效率。

Conan 2.0 是 C++ 社区广泛采用的现代化包管理器,它帮助开发者轻松管理项目依赖、构建配置和跨平台兼容性。相比早期版本,Conan 2.0 提供了更简洁的语法、更强的可维护性和更好的性能。下面介绍如何在 C++ 项目中使用 Conan 2.0 实现高效的依赖管理。
安装与初始化 Conan 2.0
确保系统已安装 Python(建议 3.8+),然后通过 pip 安装 Conan 2.0:
pip install conan安装完成后,验证版本:
conan --version你应该看到输出包含 "Conan version 2.x.x"。首次使用前,可运行初始化命令生成默认配置:
立即学习“C++免费学习笔记(深入)”;
conan config init创建 Conan 配置文件:conanfile.py
在项目根目录创建 conanfile.py,这是 Conan 的核心配置文件,用于声明依赖和构建逻辑。
例如,一个使用 fmt 库(格式化字符串)的项目配置如下:
from conan import ConanFilefrom conan.tools.cmake import CMakeToolchain, CMake
class HelloConan(ConanFile):
name = "hello"
version = "1.0"
settings = "os", "compiler", "build_type", "arch"
generators = "CMakeDeps"
def requirements(self):
self.requires("fmt/10.2.1")
def generate(self):
tc = CMakeToolchain(self)
tc.generate()
def build(self):
cmake = CMake(self)
cmake.configure()
cmake.build()
这里 requires() 声明了 fmt 库作为依赖,CMakeDeps 生成器会为 CMake 创建对应的查找模块文件。
集成到 CMake 项目
在 CMakeLists.txt 中正常使用 find_package() 即可接入 Conan 管理的库:
cmake_minimum_required(VERSION 3.15)project(hello LANGUAGES CXX)
find_package(fmt REQUIRED)
add_executable(main main.cpp)
target_link_libraries(main PRIVATE fmt::fmt)
接着,在项目目录下执行以下命令安装依赖并构建:
conan install . --output-folder=build --build=missingcd build
cmake .. -G "Unix Makefiles"
cmake --build .
Conan 会自动下载 fmt 包,并生成 CMake 所需的配置文件(如 fmt-config.cmake),使项目能顺利编译。
常用操作与技巧
一些实用命令提升开发效率:
- 搜索包:conan search fmt* —remote=conancenter
- 查看本地缓存中的包:conan list installed
- 清理旧包:conan remove "*" --confirm
- 指定构建类型:conan install . -s build_type=Debug
- 多配置项目:使用 --output-folder 分离不同构建环境(Debug/Release)
你也可以将配置写入 conanfile.txt 简化轻量项目:
[requires]fmt/10.2.1
[generators]
CMakeDeps
[layout]
cmake_layout
然后用相同命令安装依赖,Conan 会根据 layout 自动生成构建结构。
基本上就这些。Conan 2.0 让 C++ 项目摆脱手动管理第三方库的麻烦,实现类似现代语言的依赖体验。只要配好 conanfile 和 CMake,就能专注业务开发。不复杂但容易忽略的是正确设置 generator 和 toolchain,否则链接时会找不到库。











