如何使用Conan为c++项目管理依赖包 C/C++包管理器入门【工程实践】

Conan是成熟灵活的跨平台C++依赖管理工具，核心在于包定义、远程仓库、本地缓存和配置四环节；支持conanfile.txt/.py声明依赖，集成CMake生成标准文件，并可创建上传自定义包。

Conan 是 C++ 项目中成熟、灵活且跨平台的依赖管理工具，它不依赖构建系统（CMake/Make/Ninja 等均可），能统一管理头文件、静态库、动态库、构建脚本等二进制产物。用好 Conan 的关键在于理解 包定义（conanfile.py 或 conanfile.txt）、远程仓库（remote）、本地缓存（cache）和配置（profile） 四个核心环节。

1. 初始化项目并声明依赖（conanfile）

在项目根目录创建 conanfile.txt（适合简单项目）或 conanfile.py（推荐用于需要自定义逻辑的项目）。

• conanfile.txt 示例：简洁声明依赖和构建设置

[requires]
fmt/10.2.1
openssl/3.2.1
<p>[generators]
CMakeDeps
CMakeToolchain</p><p>[layout]
cmake_layout

• conanfile.py 示例：支持版本逻辑、条件依赖、自定义构建步骤

from conan import ConanFile
from conan.tools.cmake import cmake_layout
<p>class MyProject(ConanFile):
settings = "os", "compiler", "build_type", "arch"
generators = "CMakeDeps", "CMakeToolchain"</p><pre class='brush:php;toolbar:false;'>def requirements(self):
    self.requires("fmt/10.2.1")
    if self.settings.os == "Linux":
        self.requires("openssl/3.2.1")

2. 配置远程仓库与下载依赖

Conan 默认只启用 conancenter（官方中心仓库），但很多企业或私有包需添加自定义 remote。

• 查看已配置远程：conan remote list
• 添加私有仓库：conan remote add my-company https://my-conan.company.com/v1
• 安装依赖（解析 + 下载 + 生成构建所需文件）：conan install . --build=missing
• --build=missing 表示本地没有对应二进制时自动从源码构建；生产环境建议用 --build=never 强制使用预编译包

3. 在 CMake 中集成 Conan 生成的文件

Conan 通过 CMakeDeps 和 CMakeToolchain 生成标准 CMake 文件，让 CMake 原生识别 Conan 包。

标签： linux app 工具 ssl ai c++ red