Windows 与 Linux 下 vcpkg 的安装部署指南

MayZork2026-08-30 20:19

1. 引言

vcpkg 是微软推出的跨平台 C/C++ 依赖管理工具，支持 Windows、Linux 和 macOS。它能够帮助开发者快速获取、编译和集成开源库，显著简化项目依赖管理流程。简单来说类似python的pip一样，你想使用某个c++第三方库，不用再自己去下载源码然后编译，中途还容易遇到一些编译问题，还得到处查怎么解决编译问题。

2. Windows 安装部署

先安装git Git - 安装 Git

然后输入git clone https://github.com/Microsoft/vcpkg.git

输入bootstrap-vcpkg.bat

执行完成可以输入vcpkg list查看安装的包

因为现在刚安装vcpkg所以提升没有包安装

比如我现在想安装libcurl相关库组件，输入vcpkg install curl:x64-windows

过程中如果出现某些依赖包下载错误，可以修改一下网络代理或者直接复制命令中下载错误依赖包的链接然后自己去下载将下载的包放到对应的downloads目录下

注意将包名修改为命令中的名字

用同样方式可以安装其他第三方库，使用vcpkg list查看

使用export可以将第三方库相关组件导出到指定目录 vcpkg export curl --raw --output-dir=D:/libcurl_package

如果你是Qt pro工程则在pro中直接引用

复制代码

# ==========================================
# vcpkg libcurl 配置 (x64-windows)
# ==========================================
VCPKG_ROOT = E:/Vcpkg/vcpkg/installed/x64-windows

# 添加头文件搜索路径
INCLUDEPATH += $$VCPKG_ROOT/include

# 区分 Debug 和 Release 链接不同的库
CONFIG(debug, debug|release) {
    LIBS += -L$$VCPKG_ROOT/debug/lib -lcurl-d
} else {
    LIBS += -L$$VCPKG_ROOT/lib -lcurl
}

# Windows 平台下 libcurl 依赖的系统库
win32 {
    LIBS += -lws2_32 -lcrypt32 -lwldap32 -lnormaliz
}

不过使用vcpkg还是推荐使用cmakelist构建的qt工程，vcpkg对应cmake有原生的支持，只需要一句代码就行了

复制代码

find_package(CURL REQUIRED)
target_link_libraries(your_target PRIVATE CURL::libcurl)

3. Linux 安装部署

同样需要先安装git，然后使用同样的命令

执行./bootstrap-vcpkg.sh可能会出现以下报错

需要安装对应依赖

再次执行即可

vcpkg相关命令跟windows一样，比如安装第三方nlomanjson

输入./vcpkg install nlohmann-json 等待安装即可