C++如何使用vcpkg或Conan管理依赖库？（包管理器教程）

vcpkg适合新手和中小项目，微软官方支持、CMake集成简单；Conan更灵活，支持二进制分发与多配置，适合企业级复杂场景。

在C++项目中，vcpkg 和 Conan 都是主流的跨平台 C++ 包管理器，它们能帮你自动下载、构建、链接第三方库（如 Boost、fmt、spdlog、OpenCV 等），避免手动编译和路径配置的麻烦。选哪个取决于你的团队习惯、构建系统和生态偏好：vcpkg 更轻量、微软官方支持、与 CMake 集成极简；Conan 更灵活、支持二进制分发、适合企业级多配置场景。

vcpkg 快速上手（推荐新手）

vcpkg 是微软维护的开源包管理器，无需 Python 环境，命令行驱动，对 CMake 项目几乎“零配置”集成。

• 安装：Windows/macOS/Linux 均支持。推荐安装到非系统目录（如 ~/vcpkg 或 D:\vcpkg），然后运行 ./bootstrap-vcpkg.bat（Windows）或 ./bootstrap-vcpkg.sh（macOS/Linux）生成 vcpkg 可执行文件。
• 安装库：例如安装 fmt 和 yaml-cpp：
  vcpkg install fmt:x64-windows yaml-cpp:x64-windows（Windows）
  vcpkg install fmt:x64-osx yaml-cpp:x64-osx（macOS）
  默认构建静态库；加 -dynamic 后缀可构建动态版本（如 fmt:x64-windows-dynamic）。
• CMake 集成：只需在 CMakeLists.txt 开头添加两行：
  set(CMAKE_TOOLCHAIN_FILE "$ENV{VCPKG_ROOT}/scripts/buildsystems/vcpkg.cmake")
project(MyApp)
  然后用 find_package(fmt CONFIG REQUIRED) 和 target_link_libraries(myapp PRIVATE fmt::fmt) 即可。
• 注意：vcpkg 默认使用“三元组”（triplet）控制平台/架构/链接方式；常见 triplet 如 x64-windows、x64-linux、x64-osx；可通过 vcpkg list 查看已装包，vcpkg remove --outdated 清理旧版。

Conan 入门要点（适合复杂项目）

Conan 使用 Python（需 3.7+），以“配方（recipe）”描述依赖，支持私有仓库、多配置缓存、profile 切换，更适合 CI/CD 和多平台发布。

• 安装：运行 pip install conan；首次运行 conan --version 会初始化配置目录（默认 ~/.conan2）。
• 声明依赖：在项目根目录创建 conanfile.txt 或更推荐的 conanfile.py。
  conanfile.txt 示例：
  [requires]
fmt/10.2.1
spdlog/1.13.0
[generators]
CMakeDeps
CMakeToolchain
• 生成构建配置：执行 conan install . --build=missing -s build_type=Debug -s compiler.cppstd=17，Conan 会解析依赖、下载/构建缺失包，并生成 conan_toolchain.cmake 和 fmt-config.cmake 等供 CMake 使用。
• CMake 对接：在 CMakeLists.txt 中加入：
  cmake_minimum_required(VERSION 3.23)
project(MyApp)
set(CMAKE_TOOLCHAIN_FILE $ENV{CONAN_TOOLCHAIN_FILE})
include(${CMAKE_BINARY_DIR}/conan_deps.cmake)
  然后照常 find_package(fmt CONFIG REQUIRED)。

怎么选？关键区别速查

不必强求二选一，但理解差异能帮你少踩坑：

VisualizeAI

用AI把你的想法变成现实

下载

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

• 学习成本：vcpkg 命令简单，5 分钟能跑通；Conan 概念多（profile、remote、lockfile），初期略陡峭。
• 二进制复用：vcpkg 默认本地构建，相同 triplet 下可复用；Conan 支持上传二进制到远程（如 Artifactory、ConanCenter），团队共享更高效。
• 构建系统兼容性：vcpkg 天然适配 CMake；Conan 同样支持 CMake、Meson、Bazel，还提供 conan build 封装构建流程。
• Windows 支持：vcpkg 对 MSVC 运行时（MT/MD）、平台工具集（v142/v143）支持更直接；Conan 需通过 profile 显式配置（如 compiler.runtime=MDd）。

小贴士：避坑与协作建议

无论用哪个，几个实践能显著提升稳定性：

• 固定版本：避免写 fmt/10.x，用具体版本如 fmt/10.2.1 或锁文件（vcpkg 的 vcpkg.json、Conan 的 conan.lock）。
• 不要提交构建产物：vcpkg 的 installed/、Conan 的 .conan2/ 不进 Git；但应提交 vcpkg.json 或 conanfile.txt 和 lock 文件。
• CI 中预装：GitHub Actions 可用 microsoft/vcpkg@v1 或 conan-io/conan@v2 Action 加速；自建 CI 推荐预缓存常用 triplet 或 profile。
• 混合使用？：不推荐。一个项目只用一种主包管理器；若必须混用（如已有 vcpkg 基础 + 新模块需 Conan 私有库），可用 vcpkg export 导出为 Conan 包，或用 conan install --require=vcpkg::xxx（需插件支持）。

基本上就这些。vcpkg 适合快速启动、中小项目、Windows 主力开发；Conan 更适合需要精细控制、多环境交付、或已有 Python/CI 基建的团队。动手试一次，比读十篇文档管用。