Conan是C++跨平台依赖管理工具,通过conanfile声明依赖并生成CMake配置,结合CMake实现多平台构建,支持私有仓库协作,降低项目复杂度。

在C++开发中,依赖管理一直是个痛点。Conan作为主流的跨平台C/C++包管理器,能够帮助开发者轻松管理第三方库的获取、编译和链接。它不依赖于特定构建系统(如CMake),但与CMake集成良好,适合现代C++项目的工程化实践。
安装Conan
Conan基于Python开发,因此需要先安装Python 3.7以上版本。
pip install conan安装完成后可通过以下命令验证:
conan --version首次运行时会生成默认配置目录(通常位于~/.conan2)。
立即学习“C++免费学习笔记(深入)”;
初始化项目并添加依赖
在项目根目录创建conanfile.txt或使用更灵活的conanfile.py来声明依赖。
示例:使用conanfile.txt引入fmt库(一个现代C++格式化库):
[requires]
fmt/10.2.1
[generators]
CMakeToolchain
CMakeDeps
说明:
- requires:列出项目依赖的包及其版本
-
generators:生成构建系统可用的配置文件。
CMakeToolchain和CMakeDeps是Conan 2.x推荐方式
配置构建流程(以CMake为例)
确保CMakeLists.txt基本结构如下:
cmake_minimum_required(VERSION 3.15)project(myapp)
find_package(fmt REQUIRED)
add_executable(app main.cpp)
target_link_libraries(app fmt::fmt)
接着在构建目录执行Conan安装命令:
conan install . --output-folder=build --build=missing --settings:build=os=Linux --settings:build=arch=x86_64 --settings:target=os=Linux --settings:target=arch=x86_64该命令会:
- 解析依赖并下载所需包
- 生成CMake工具链文件(如
conan_toolchain.cmake) - 生成
xxxConfig.cmake文件供CMake查找包
然后调用CMake进行构建:
cd buildcmake .. -DCMAKE_TOOLCHAIN_FILE=conan_toolchain.cmake
cmake --build .
使用conanfile.py进行高级控制
对于复杂项目,建议使用conanfile.py代替conanfile.txt。
示例简化版:
from conan import ConanFilefrom conan.tools.cmake import CMake
class MyProject(ConanFile):
name = "myapp"
version = "1.0"
settings = "os", "compiler", "build_type", "arch"
requires = "fmt/10.2.1"
generators = "CMakeToolchain", "CMakeDeps"
def build(self):
cmake = CMake(self)
cmake.configure()
cmake.build()
这样可以用conan create .打包并构建整个项目。
私有仓库与团队协作
Conan支持自建Artifactory或使用JFrog等服务托管私有包。
添加远程仓库:
conan remote add myrepo https://mycompany.jfrog.io/artifactory/api/conan/conan-local上传包到私有仓库前需创建并导出:
conan export . --name=mylib --version=1.0conan build .
conan export-pkg . --name=mylib --version=1.0 --force
conan upload mylib/1.0 --remote=myrepo
基本上就这些。Conan降低了C++依赖管理的复杂度,尤其适合跨平台项目。配合CMake使用后,能实现“写一次依赖,多平台构建”的效果。关键在于理解其生成器机制和构建上下文分离的设计逻辑。










