技术学院

c++ Conan怎么管理依赖 c++包管理器Conan入门【工具】

作者:尼克2026-01-07 00:00:00

Conan 是 C++ 跨平台包管理器，通过 conanfile 声明依赖、conan install 下载/构建/生成配置，并集成到 CMake 流程中实现自动化依赖管理。

Conan 是 C++ 领域主流的跨平台包管理器，它不依赖构建系统（CMake/Make/Ninja 等），但能和它们无缝协作。核心思路是：把第三方库（如 fmt、Boost、OpenSSL）打包成可复用、可版本化、可配置的二进制“包”，再通过 conanfile.py 或 conanfile.txt 声明依赖，由 Conan 自动下载、构建（必要时）、安装并注入到你的构建流程中。

初始化项目并声明依赖

在项目根目录创建 conanfile.txt（适合简单项目）或 conanfile.py（推荐，更灵活）：

conanfile.txt 示例：

[requires]
fmt/10.2.1
zlib/1.3.1
[generators]
CMakeDeps
CMakeToolchain

conanfile.py 示例（功能更强）：

from conan import ConanFile from conan.tools.cmake import CMakeDeps, CMakeToolchain

class MyApp(ConanFile): settings = "os", "arch", "compiler", "build_type" requires = "fmt/10.2.1", "zlib/1.3.1"

def generate(self):
    tc = CMakeToolchain(self)
    tc.generate()
    deps = CMakeDeps(self)
    deps.generate()

运行 conan install . --build=missing 即可拉取依赖并生成 CMake 所需的配置文件（conan_toolchain.cmake、fmt-release-x86_64-data.cmake 等）。

集成到 CMake 构建流程

修改你的 CMakeLists.txt，让 CMake 加载 Conan 生成的配置：

在 project() 之前加入：cmake_minimum_required(VERSION 3.23)（推荐 3.23+，兼容 Conan 2.x 的 generator）
在 project() 之后添加：include(${CMAKE_BINARY_DIR}/conan_toolchain.cmake)
用 find_package(fmt CONFIG REQUIRED) 查找依赖，再 target_link_libraries(myapp PRIVATE fmt::fmt)

这样 CMake 就能自动找到头文件路径、链接库、编译定义等，无需手动写 include_directories() 或硬编码路径。

使用远程仓库与私有包

Conan 默认从 ConanCenter（官方免费仓库）拉取包。你也可以添加其他远程源：

查看当前远程：conan remote list
添加自建 Artifactory 或 Nexus：conan remote add my-remote https://my-server.com/v1
上传自己的包：conan create . --name=mylib --version=1.0（先本地测试），再 conan upload mylib/1.0 -r=my-remote --force

私有项目建议配置 conan remote add --force conancenter https://center.conan.io 显式启用官方源，并用 conan profile 管理不同环境（如 Windows MSVC / Linux GCC）的设置。

常见问题快速应对

找不到包？ 检查拼写和版本号，访问 conan.io/center 确认是否存在；也可用 conan search "fmt*" -r conancenter 搜索
编译失败？ 多数因编译器设置不匹配。运行 conan profile show default 查看默认 profile，用 conan profile update 调整 settings.compiler.version 等字段
想跳过二进制重用、强制源码构建？ 加 --build=missing（仅缺时构建）或 --build=* （全部源码构建）
多个子项目共享依赖？ 推荐用 conan lock 生成 conan.lock 文件，锁定所有传递依赖版本，确保可重现构建

Conan 的本质是“声明式依赖 + 自动生成构建上下文”，掌握 conan install、conanfile 和 CMake 集成这三点，就能覆盖绝大多数 C++ 项目依赖管理场景。

上一篇丨

为什么视频流媒体需要特定编码格式？

下一篇丨

夸克忘记密码了如何找回_夸克账号密码找回流程

全国咨询热线： 400-8878-609

新闻资讯

技术学院

c++ Conan怎么管理依赖 c++包管理器Conan入门【工具】

初始化项目并声明依赖

联系我们