# Vcpkg使用总结2

1. 什么是 vcpkg

vcpkg 是一个开源的 C/C++ 包管理器，由 Microsoft 开发和维护，主要用于简化 C++ 项目中第三方库的安装和管理过程。它支持跨平台使用，包括 Windows、Linux 和 macOS。

2. vcpkg 的主要用途

• 跨平台的第三方库管理：在多个操作系统上使用相同的命令管理库
• 快速安装和更新：自动处理依赖关系，一键安装所需库
• 集成到项目中：与 CMake、Visual Studio 等构建系统无缝集成
• 大量可用的库：维护了庞大的第三方库仓库，涵盖各种常用 C++ 库

3. 安装 vcpkg

3.1 从 GitHub 克隆

git clone 
cd vcpkg
# Windows 平台
.ootstrap-vcpkg.bat
# Linux/macOS 平台
./bootstrap-vcpkg.sh

3.2 添加到系统环境变量

将 vcpkg 目录添加到系统的 PATH 环境变量中，以便在任何位置都能使用 vcpkg 命令。

4. 基本命令

4.1 安装库

# 基本安装
vcpkg install <library-name>

# 指定平台架构
vcpkg install <library-name>:<triplet>
# 例如：安装 64 位 Windows 版本的 OpenCV
vcpkg install opencv4:x64-windows

4.2 搜索库

# 搜索库
vcpkg search <query>
# 例如：搜索与 opencv 相关的库
vcpkg search opencv

# 列出所有已安装的库
vcpkg list

4.3 更新库

# 更新所有已安装的库
vcpkg upgrade

# 更新指定库
vcpkg upgrade <library-name>

4.4 移除库

# 移除指定库
vcpkg remove <library-name>

# 移除库及其依赖
vcpkg remove --recurse <library-name>

5. 高级功能

5.1 设置代理

vcpkg 支持通过环境变量设置代理，以便在网络受限环境中使用：

# Windows (cmd)
set http_proxy=
set https_proxy=

# Windows (PowerShell)
$env:http_proxy="http://your-proxy:port"
$env:https_proxy="https://your-proxy:port"

# Linux/macOS
export http_proxy=
export https_proxy=

# 然后运行 vcpkg 命令
vcpkg install <library-name>

5.2 打包现有库

vcpkg 允许你为自己的库创建端口，以便通过 vcpkg 进行管理：

1. 在 vcpkg 目录下创建端口目录：ports/<your-library-name>
2. 创建 portfile.cmake 文件，定义库的获取、构建和安装过程
3. 创建 vcpkg.json 文件，定义库的元数据
4. 运行 vcpkg install <your-library-name> 测试打包

5.3 导出库

# 导出已安装的库到指定目录
vcpkg export --zip --output=my-export.zip <library-name>

# 导出所有已安装的库
vcpkg export --zip --output=all-libraries.zip

5.4 版本控制

vcpkg 支持使用清单文件 (vcpkg.json) 来管理项目依赖，确保团队成员使用相同版本的库：

1. 在项目根目录创建 vcpkg.json 文件：

{
  "name": "my-project",
  "version-string": "1.0.0",
  "dependencies": [
    "opencv4",
    "boost"
  ]
}

2. 运行 vcpkg install 安装依赖

6. 集成到项目

6.1 与 Visual Studio 集成

# 全局集成（所有 VS 项目都可以使用）
vcpkg integrate install

# 项目级集成
vcpkg integrate project
# 然后按照提示在 VS 中安装生成的 NuGet 包

6.2 与 CMake 集成

在 CMakeLists.txt 文件中设置 vcpkg 工具链文件：

cmake_minimum_required(VERSION 3.5)

# 设置 vcpkg 工具链文件
set(CMAKE_TOOLCHAIN_FILE "<path-to-vcpkg>/scripts/buildsystems/vcpkg.cmake")

project(YourProject)

# 查找并使用库
find_package(OpenCV REQUIRED)

# 添加可执行文件并链接库
add_executable(YourExecutable main.cpp)
target_link_libraries(YourExecutable PRIVATE ${OpenCV_LIBS})

7. 常见问题与解决方案

7.1 安装失败

• 问题：网络连接问题导致下载失败 解决方案：设置代理，或使用 --binarysource 参数指定本地二进制源

• 问题：依赖冲突 解决方案：使用 vcpkg remove 移除冲突的库，然后重新安装

7.2 库找不到

• 问题：CMake 找不到通过 vcpkg 安装的库 解决方案：确保正确设置了 CMAKE_TOOLCHAIN_FILE，并使用正确的 triplet

7.3 版本问题

• 问题：需要特定版本的库 解决方案：在 vcpkg.json 中指定版本约束，例如：

  {
    "dependencies": [
      {"name": "opencv4", "version>=": "4.5.0"}
    ]
  }
  

8. 最佳实践

1. 使用清单文件：在项目中使用 vcpkg.json 管理依赖，确保版本一致性
2. 定期更新：定期运行 vcpkg upgrade 保持库的最新状态
3. 缓存管理：使用 vcpkg cache 命令管理构建缓存，提高构建速度
4. 多平台支持：为不同平台安装相应的库版本，例如：

   vcpkg install opencv4:x64-windows
   vcpkg install opencv4:x64-linux
   

5. 文档查询：使用 vcpkg help 查看命令帮助，或访问 vcpkg 文档 获取详细信息

9. 示例：使用 vcpkg 构建 OpenCV 项目

9.1 安装 OpenCV

vcpkg install opencv4:x64-windows

9.2 创建 CMake 项目

CMakeLists.txt：

cmake_minimum_required(VERSION 3.5)
set(CMAKE_TOOLCHAIN_FILE "<path-to-vcpkg>/scripts/buildsystems/vcpkg.cmake")
project(OpenCVTest)
find_package(OpenCV REQUIRED)
add_executable(OpenCVTest main.cpp)
target_link_libraries(OpenCVTest PRIVATE ${OpenCV_LIBS})

main.cpp：

#include <opencv2/opencv.hpp>
#include <iostream>

using namespace cv;
using namespace std;

int main() {
    // 读取图片
    Mat img = imread("test.png");
    
    if (img.empty()) {
        cout << "Could not read the image" << endl;
        return 1;
    }
    
    // 显示图片
    namedWindow("image", WINDOW_NORMAL);
    imshow("image", img);
    
    // 等待按键
    waitKey(0);
    
    // 释放窗口
    destroyAllWindows();
    return 0;
}

9.3 构建和运行

mkdir build && cd build
cmake ..
cmake --build .
# 运行程序
./OpenCVTest

10. 总结

vcpkg 是一个强大的 C++ 包管理器，它简化了第三方库的安装和管理过程，提供了跨平台的支持，使得开发者能够更专注于项目的核心功能。通过掌握 vcpkg 的使用方法和最佳实践，你可以更高效地构建和管理 C++ 项目，减少依赖管理的复杂性。

参考链接：

• vcpkg 官方网站
• vcpkg GitHub 仓库
• vcpkg 文档