> 如果文章有任何不正确或者你觉得可以补充的建议，欢迎留言，我希望这篇文章可以成为后来人做选择时的速查手册

> 面对复杂的C++依赖，选对工具能让你事半功倍。这份速查手册让你三分钟内找到最适合你的包管理器，并掌握其核心用法。

## 一、快速决策指南

### 1. 我应该选择哪个工具？

*   **选 vcpkg，如果你是**：Windows/Visual Studio 用户，追求与IDE无缝集成，需要简单快速上手。
*   **选 Conan，如果你是**：参与企业级大型项目，依赖关系复杂，需要强大的版本管理和团队协作能力。
*   **选 xmake，如果你是**：国内开发者或学生，追求极简安装和配置，希望避开网络环境问题。

### 2. 核心对比速览

| 维度         | vcpkg (微软)    | Conan (社区)     | xmake (国产)     |
|--------------|----------------|------------------|------------------|
| **核心理念**  | 简单集成，开箱即用 | 灵活强大，企业级方案 | 极简体验，一站解决 |
| **学习曲线**  | 低             | 中高             | 极低             |
| **网络友好度** | 良（可配镜像）   | 良（可配镜像）     | **优（内置优化）** |
| **VS集成度**  | **完美**        | 良好             | 良好             |

## 二、vcpkg 快速上手

### 1. 核心命令速查

```bash
# 1. 克隆仓库
git clone https://github.com/microsoft/vcpkg.git
cd vcpkg

# 2. 执行引导脚本
# Windows:
.\bootstrap-vcpkg.bat
# Linux/macOS:
./bootstrap-vcpkg.sh

# 3. 安装包
vcpkg install fmt boost

# 4. 集成到VS（全局）
vcpkg integrate install

# 5. 移除集成
vcpkg integrate remove
```

### 2. 项目集成示例（CMake）

```cmake
# CMakeLists.txt 示例
cmake_minimum_required(VERSION 3.10)
project(MyProject)

# 查找包
find_package(fmt REQUIRED)

add_executable(my_app main.cpp)
# 链接库
target_link_libraries(my_app PRIVATE fmt::fmt)
```

**编译命令**（需传递工具链）：
```bash
cmake -B build -S . -DCMAKE_TOOLCHAIN_FILE=[vcpkg-root]/scripts/buildsystems/vcpkg.cmake
cmake --build build
```

### 3. 实用技巧
- **镜像加速**：在 `vcpkg-configuration.json` 中配置清华/中科大镜像
- **仅安装头文件库**：`vcpkg install header-only-library`
- **查看已安装包**：`vcpkg list`

## 三、Conan 核心操作

### 1. 安装与基础配置

```bash
# 安装（Python pip方式）
pip install conan

# 生成默认配置
conan profile detect --force

# 创建并进入构建目录
mkdir build && cd build
```

### 2. 依赖管理流程

```bash
# 1. 搜索包
conan search fmt --remote=conancenter

# 2. 创建conanfile.txt（或.py用于复杂配置）
# conanfile.txt 内容示例：
[requires]
fmt/10.1.1

[generators]
CMakeDeps
CMakeToolchain

# 3. 安装依赖
conan install .. --output-folder=. --build=missing

# 4. 构建（配合CMake）
cmake .. -DCMAKE_TOOLCHAIN_FILE=conan_toolchain.cmake -DCMAKE_BUILD_TYPE=Release
cmake --build .
```

### 3. 高级功能速查

```bash
# 创建自己的conan包
conan new hello/1.0 -m=cmake_lib

# 本地打包
conan create .

# 上传到私有仓库
conan upload hello/1.0 -r=my-remote --all
```

## 四、xmake 极简工作流

### 1. 安装与项目创建

```bash
# 一键安装
curl -fsSL https://xmake.io/shget.text | bash
# 或通过其他包管理器安装

# 创建新项目
xmake create my_project

# 进入项目
cd my_project
```

### 2. 基础操作命令

```bash
# 添加依赖（编辑xmake.lua或通过命令）
xmake require fmt

# 配置项目
xmake config --mode=debug

# 构建
xmake

# 运行
xmake run

# 调试
xmake run -d
```

### 3. xmake.lua 配置示例

```lua
-- xmake.lua 最小示例
add_rules("mode.debug", "mode.release")

target("my_app")
    set_kind("binary")
    add_files("src/*.cpp")
    add_packages("fmt", "spdlog")
```

## 五、常见场景解决方案

### 场景1：Windows + Visual Studio 开发

**首选 vcpkg**：
1. 安装 vcpkg 并全局集成
2. 在VS中直接 `#include <library>` 无需额外配置
3. 使用 `vcpkg install` 安装的库自动对VS可见

### 场景2：跨平台团队项目

**首选 Conan**：
1. 在 `conanfile.py` 中精确定义依赖版本和配置
2. 使用 `conan lock` 创建版本锁文件确保一致性
3. 通过 Artifactory 搭建私有仓库，管理内部二进制包

### 场景3：快速原型/个人项目

**首选 xmake**：
1. 一个 `xmake.lua` 文件统一管理构建和依赖
2. 无需编写复杂的CMakeLists.txt
3. 支持中文错误信息，对新手友好

### 场景4：已有CMake项目改造

**渐进式方案**：
1. **初期**：保留CMake，用 vcpkg 管理依赖（通过工具链集成）
2. **中期**：部分模块使用 Conan 管理，CMake + Conan 混合
3. **长期**：评估是否需要完全迁移到 xmake（需重写构建配置）

## 六、排错与优化

### 1. 网络问题解决方案

**所有工具通用**：
```bash
# 配置国内镜像源
# vcpkg: 配置 vcpkg-configuration.json
# Conan: conan remote add 镜像源
# xmake: 默认已优化，也可通过 xmake g --proxy=xxx 配置
```

### 2. 编译速度优化

- **vcpkg**：使用 `--binarycaching` 开启二进制缓存
- **Conan**：上传二进制包到私有仓库，避免重复编译
- **xmake**：使用 `xmake build --jobs=8` 并行编译

### 3. 常见错误处理

| 错误现象                 | 可能原因               | 解决方案                     |
|--------------------------|------------------------|------------------------------|
| 找不到包                | 拼写错误或版本不存在    | 使用工具搜索功能确认包名     |
| 链接错误                | 库版本与编译器不兼容    | 检查库支持的编译器版本       |
| CMake找不到包           | 工具链未正确传递        | 确认 `-DCMAKE_TOOLCHAIN_FILE` 参数 |

## 七、迁移指南

### 从手动管理迁移

1. **清点现有依赖**：整理所有第三方库名称、版本、编译选项
2. **选择目标工具**：根据团队情况选择上述任一工具
3. **逐步迁移**：从非关键依赖开始，逐个替换

### 工具间迁移

| 迁移方向         | 关键步骤                              | 注意事项                     |
|------------------|---------------------------------------|------------------------------|
| **vcpkg → Conan** | 1. 创建conanfile<br>2. 替换CMake集成方式 | 注意二进制兼容性和版本差异   |
| **Conan → xmake** | 1. 编写xmake.lua<br>2. 重新配置构建流程 | xmake的包可能比Conan少      |

## 八、进阶资源

- **vcpkg**：`vcpkg export` 命令可导出已安装包，便于离线环境使用
- **Conan**：掌握 `conan graph` 和 `conan info` 分析依赖关系
- **xmake**：探索 `xmake package` 打包功能和插件系统

---

**总结**：没有“最好”的工具，只有“最合适”的工具。对于大多数开发者：
- **日常开发选 vcpkg**，省心省力
- **复杂项目选 Conan**，可控可管  
- **国内环境选 xmake**，简单直接

**立即行动建议**：从一个小型测试项目开始，用一天时间分别尝试三个工具的基本流程，亲身感受后做出选择。

如果文章有任何不正确或者你觉得可以补充的建议，欢迎留言，我希望这篇文章可以成为后来人做选择时的速查手册

C++ 依赖管理三剑客：vcpkg、Conan、xmake 速查手册

高级后端开发工程师

后端

编程语言

开发工具

C++开发者必备包管理器速查手册：vcpkg、Conan、xmake三大工具对比与实战指南。快速掌握各工具安装配置、核心命令、项目集成技巧，解决Windows/跨平台开发中的依赖管理难题。包含镜像加速、编译优化等实用技巧，助你根据项目需求选择最适合的解决方案。

包管理器

编译器

Windows

Linux

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

C++ 依赖管理三剑客：vcpkg、Conan、xmake 速查手册-腾讯云开发者社区-腾讯云

C++ 依赖管理三剑客：vcpkg、Conan、xmake 速查手册

C++ 依赖管理三剑客：vcpkg、Conan、xmake 速查手册

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐