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

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

冰火之心

发布： 2025-12-20 17:15:36

原创

137人浏览过

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

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

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 包。

Supermeme

Supermeme是一个AI驱动的Meme生成器，可以快速生成有趣的Meme梗图

114

查看详情

立即学习“C++免费学习笔记（深入）”；

CMakeDeps 生成 *-config.cmake 文件（如 fmt-config.cmake），供 find_package() 使用
CMakeToolchain 生成 conan_toolchain.cmake，统一传递编译器、架构、标准等设置
CMakeLists.txt 中只需两行即可接入：

cmake_minimum_required(VERSION 3.23)
project(MyApp)
<h1>加载 Conan 提供的 toolchain（必须放在 project() 之后、其他命令之前）</h1><p>set(CMAKE_TOOLCHAIN_FILE $ENV{CONAN_TOOLCHAIN_FILE} CACHE STRING "")
if(EXISTS ${CMAKE_TOOLCHAIN_FILE})
include(${CMAKE_TOOLCHAIN_FILE})
endif()</p><h1>查找并链接 Conan 包</h1><p>find_package(fmt REQUIRED)
add_executable(app main.cpp)
target_link_libraries(app fmt::fmt)

登录后复制

4. 创建并上传自己的包（conan create / conan upload）

将你自己的库发布为 Conan 包，便于团队复用或 CI 统一管理。

编写 conanfile.py 描述包元信息、源码位置、构建逻辑和包结构
本地测试打包：conan create . --name=mylib --version=1.0.0
上传到远程：conan upload "mylib/1.0.0" -r=my-company --all
注意：上传前确保 remote 已登录（conan user -r my-company -p xxx）且包名/版本符合语义化规则

Conan 不是“黑盒”，它的设计围绕可重现性与可审计性展开。只要理清包声明、远程协作、CMake 集成和本地开发流程这四个支点，就能稳定支撑中小型到大型 C++ 工程的依赖治理。不需要一开始就写复杂 conanfile.py，从 conanfile.txt 起步，再逐步引入 profile、lockfile 和私有 remote，节奏更可控。

以上就是如何使用Conan为c++++项目管理依赖包 C/C++包管理器入门【工程实践】的详细内容，更多请关注php中文网其它相关文章！