vcpkg：C++ 包管理器安装与使用指南

已于 2025-04-28 15:48:48 修改
阅读量1.9k 收藏 36
点赞数 22
文章标签： c++
于 2025-03-16 17:29:17 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/2301_81011704/article/details/146298099
版权

vcpkg：C++ 包管理器安装与使用指南

1. 简介

vcpkg 是微软开发的一款跨平台的 C++ 包管理器，旨在简化 C++ 库的获取、构建和集成过程。它支持 Windows、Linux 和 macOS，并能与 CMake、MSBuild 等构建系统无缝集成。

使用 vcpkg 的主要优势：

优势说明
简化依赖管理自动处理库的下载、编译和安装
跨平台支持在不同操作系统上提供一致的体验
与构建系统集成通过工具链文件轻松集成到 CMake 等项目中
版本控制支持清单模式，实现可复现的构建和依赖版本锁定
社区驱动拥有庞大的社区和不断增长的库支持

本文档将指导您完成 vcpkg 的安装、环境配置、IDE 集成（重点是 VSCode）以及项目中的使用方法。

2. 安装 vcpkg

2.1 获取 vcpkg

获取 vcpkg 的推荐方式是使用 Git 克隆其仓库：

  1. 打开终端或命令提示符。

  2. 导航到您希望安装 vcpkg 的父目录（例如 C:\dev 或 ~/dev）。

  3. 运行克隆命令：

    # Windows (PowerShell)
git clone https://github.com/microsoft/vcpkg.git

    # Linux/macOS
git clone https://github.com/microsoft/vcpkg.git

    这会将 vcpkg 克隆到当前目录下的 vcpkg 文件夹中。

💡 提示： 您也可以将 vcpkg 作为项目的 Git 子模块添加：

git submodule add https://github.com/microsoft/vcpkg.git

替代方法（不推荐）： 您也可以从 vcpkg GitHub Releases 下载 ZIP 压缩包并解压，但这不利于后续更新 vcpkg。

2.2 引导 vcpkg (Bootstrap)

克隆完成后，需要运行引导脚本来编译 vcpkg 工具本身：

  1. 进入 vcpkg 目录：

    cd vcpkg

  2. 根据您的操作系统运行对应的引导脚本：

    操作系统命令
    Windows (PowerShell).\bootstrap-vcpkg.bat
    Windows (CMD)bootstrap-vcpkg.bat
    Linux / macOS./bootstrap-vcpkg.sh

引导脚本执行成功后，vcpkg.exe (Windows) 或 vcpkg (Linux/macOS) 可执行文件就会生成在 vcpkg 根目录下。

🔍 注意： 首次引导可能需要一些时间，因为它需要编译 vcpkg 可执行文件。请确保您的系统已安装所需的构建工具（如 Visual Studio Build Tools 或 GCC）。

3. 配置环境变量 (可选但推荐)

配置环境变量可以让您在系统的任何位置调用 vcpkg 命令，并简化与 CMake 等工具的集成。您可以选择全局配置或项目级配置。

3.1 环境变量说明
  • VCPKG_ROOT: 指向 vcpkg 的安装根目录（包含 vcpkg.exe 或 vcpkg 可执行文件的目录）。这是最重要的环境变量，许多工具（如 CMake）会依赖它来找到 vcpkg 工具链。
  • PATH: 将 vcpkg 根目录添加到系统的 PATH 环境变量中，允许您直接在终端中运行 vcpkg 命令，而无需指定完整路径。
  • VCPKG_DEFAULT_TRIPLET: (可选) 设置默认的目标平台架构（称为 “triplet”）。如果不设置，vcpkg 会根据您的系统自动选择一个默认值（例如 x64-windows 或 x64-linux）。设置此变量可以简化 vcpkg install 命令，无需每次都指定 --triplet 参数。常见 Triplets 请参见 章节 6。
3.2 全局配置 (影响所有项目)

适用于需要在多个项目中频繁使用相同 vcpkg 实例的情况。

  • Windows:

    1. 搜索 “编辑系统环境变量” 并打开。
    2. 点击 “环境变量…” 按钮。
    3. 在 “系统变量” (或 “用户变量”) 区域：
      • 点击 “新建…”，变量名输入 VCPKG_ROOT，变量值输入 vcpkg 的完整路径 (例如 C:\dev\vcpkg)。
      • (可选) 点击 “新建…”，变量名输入 VCPKG_DEFAULT_TRIPLET，变量值输入您希望的默认 Triplet (例如 x64-windows)。
      • 找到 Path 变量，点击 “编辑…”，然后点击 “新建”，输入 %VCPKG_ROOT%。
    4. 点击 “确定” 保存所有更改。您可能需要重启终端或 VSCode 才能使更改生效。

  • Linux / macOS:
    编辑您的 shell 配置文件（例如 ~/.bashrc, ~/.zshrc, ~/.profile 等），在文件末尾添加以下行：

    export VCPKG_ROOT="/path/to/your/vcpkg" # 替换为实际路径
export PATH="$VCPKG_ROOT:$PATH"
# export VCPKG_DEFAULT_TRIPLET="x64-linux" # 可选，替换为所需 Triplet

    保存文件后，运行 source ~/.bashrc (或相应的文件名) 或重启终端使更改生效。

3.3 项目级配置 (推荐用于隔离)

更推荐的方式是在项目级别配置 vcpkg，特别是当您希望将 vcpkg 作为项目的一部分（例如 Git 子模块）或者不同项目需要不同 vcpkg 版本/配置时。

  • 在终端中临时设置 (仅当前会话有效):
    • Windows PowerShell:
      $env:VCPKG_ROOT="C:\path\to\vcpkg" # 或 $env:VCPKG_ROOT="${workspaceFolder}\vcpkg"
$env:PATH="$env:VCPKG_ROOT;$env:PATH"
# $env:VCPKG_DEFAULT_TRIPLET="x64-windows" # 可选
    • Linux / macOS Bash:
      export VCPKG_ROOT="/path/to/vcpkg" # 或 export VCPKG_ROOT="${PWD}/vcpkg"
export PATH="$VCPKG_ROOT:$PATH"
# export VCPKG_DEFAULT_TRIPLET="x64-linux" # 可选
  • 使用 VSCode 工作区设置 (推荐):
    这是在 VSCode 中为特定项目配置 vcpkg 环境的最佳方式，尤其是当 vcpkg 位于项目文件夹内时。

    1. 在 VSCode 中打开您的项目工作区。

    2. 打开命令面板 (Ctrl+Shift+P)，搜索并选择 “Preferences: Open Workspace Settings (JSON)”。 3. 在打开的 settings.json 文件中，添加或修改 terminal.integrated.env.* 配置：

      {
  "terminal.integrated.env.windows": {
    "VCPKG_ROOT": "${workspaceFolder}\\vcpkg",
    "PATH": "${workspaceFolder}\\vcpkg;${env:PATH}",
    "VCPKG_DEFAULT_TRIPLET": "x64-windows"
  },
  "terminal.integrated.env.linux": {
    "VCPKG_ROOT": "${workspaceFolder}/vcpkg",
    "PATH": "${workspaceFolder}/vcpkg:${env:PATH}",
    "VCPKG_DEFAULT_TRIPLET": "x64-linux"
  },
  "terminal.integrated.env.osx": {
    "VCPKG_ROOT": "${workspaceFolder}/vcpkg",
    "PATH": "${workspaceFolder}/vcpkg:${env:PATH}",
    "VCPKG_DEFAULT_TRIPLET": "x64-osx"
  }
}
      • terminal.integrated.env.windows/linux/osx: 为不同操作系统的VSCode集成终端设置环境变量
      • VCPKG_ROOT: 指向vcpkg的安装路径，此处使用工作区相对路径
      • PATH: 将vcpkg目录添加到系统路径
      • VCPKG_DEFAULT_TRIPLET: 设置默认目标平台架构

    3. 说明:

      • ${workspaceFolder} 是 VSCode 提供的变量，指向当前工作区的根目录。
      • ${env:PATH} 会将系统原有的 PATH 变量包含进来。
      • 请根据您的 vcpkg 实际位置和目标平台调整路径和 Triplet。
      • 保存 settings.json 后，新打开的 VSCode 集成终端 (`Ctrl+``) 将自动应用这些环境变量。
      • 将 .vscode/settings.json 文件提交到版本控制系统，可以确保团队成员共享相同的开发环境配置。

4. IDE 集成

4.1 Visual Studio Code (推荐)

VSCode 通过 CMake Tools 扩展可以与 vcpkg 良好集成。

  1. 安装必要扩展:

    • C/C++: 来自 Microsoft，提供语言支持、调试等。
    • CMake Tools: 来自 Microsoft，提供 CMake 项目管理、构建和调试支持。

  2. 配置 CMake 以使用 vcpkg:
    核心是告知 CMake 使用 vcpkg 提供的工具链文件 (scripts/buildsystems/vcpkg.cmake)。推荐使用 CMakePresets.json 或 CMakeUserPresets.json 文件进行配置。 * 创建/编辑 CMakePresets.json 或 CMakeUserPresets.json:
    在项目根目录下创建（或由 CMake Tools 自动生成）该文件。一个典型的配置如下：

{
  "version": 3,
  "configurePresets": [
    {
      "name": "default",
      "displayName": "Default Config with vcpkg",
      "description": "Uses vcpkg toolchain",
      "generator": "Ninja",
      "binaryDir": "${sourceDir}/build/${presetName}",
      "cacheVariables": {
        "CMAKE_TOOLCHAIN_FILE": "${sourceDir}/vcpkg/scripts/buildsystems/vcpkg.cmake",
        "VCPKG_TARGET_TRIPLET": "x64-windows"
      }
    }
  ],
  "buildPresets": [
    {
      "name": "default-debug",
      "configurePreset": "default",
      "configuration": "Debug"
    },
    {
      "name": "default-release",
      "configurePreset": "default",
      "configuration": "Release"
    }
  ],
  "testPresets": []
}

CMakePresets.json 配置说明:

字段说明
versionCMake Presets格式版本，3或更高版本
name预设名称，可以是任何描述性名称
generatorCMake生成器，如Ninja或"Visual Studio 17 2022"
binaryDir构建文件输出目录
CMAKE_TOOLCHAIN_FILE 指向vcpkg工具链文件的路径，有三种方式指定：
1. 相对路径：${sourceDir}/vcpkg/scripts/buildsystems/vcpkg.cmake
2. 环境变量：$env{VCPKG_ROOT}/scripts/buildsystems/vcpkg.cmake
3. 绝对路径(不推荐)：C:/dev/vcpkg/scripts/buildsystems/vcpkg.cmake
VCPKG_TARGET_TRIPLET可选，设置目标平台架构

选择配置预设:
1. 保存 CMakePresets.json 文件。
2. 在 VSCode 底部状态栏，CMake Tools 会自动检测到预设。点击状态栏上的 “[No Configure Preset Selected]” 或当前预设名称。
3. 从弹出的列表中选择您定义的配置预设（例如 default）。
4. CMake Tools 将使用选定的预设（包括 vcpkg 工具链）来配置项目。 * 替代方法 (不推荐): .vscode/settings.json
您也可以在 .vscode/settings.json 中设置 cmake.configureSettings，但这不如 Presets 灵活，且优先级较低。

{
  "cmake.configureSettings": {
    "CMAKE_TOOLCHAIN_FILE": "${workspaceFolder}/vcpkg/scripts/buildsystems/vcpkg.cmake",
    "VCPKG_TARGET_TRIPLET": "x64-windows"
  }
}
4.2 Visual Studio (Classic)

对于 Visual Studio 用户，vcpkg 提供了全局集成命令：

# 确保在正确的 vcpkg 目录下执行，或者 VCPKG_ROOT 已设置
vcpkg integrate install

此命令会将 vcpkg 与 MSBuild 集成，使得在 Visual Studio 中打开的 C++ 项目能够自动发现并使用通过 vcpkg 安装的库（无需手动配置项目属性）。

注意事项:

  • 潜在冲突: 如果您的 Visual Studio 安装程序也安装了 vcpkg 的某个版本，或者系统中有多个 vcpkg 实例，integrate install 可能会导致混淆。建议在运行此命令前，通过设置 VCPKG_ROOT 环境变量明确指定要集成的 vcpkg 实例。
    # PowerShell 示例
$env:VCPKG_ROOT="C:\path\to\your\preferred\vcpkg"
$env:PATH="$env:VCPKG_ROOT;$env:PATH"
vcpkg integrate install
  • 移除集成: 如果需要移除全局集成，可以运行 vcpkg integrate remove。
  • VSCode 用户: vcpkg integrate install 主要影响 Visual Studio (MSBuild)，对基于 CMake 和 VSCode 的工作流影响不大（CMake 通过 CMAKE_TOOLCHAIN_FILE 集成）。

5. 在 CMake 项目中使用 vcpkg

vcpkg 提供了两种主要的工作模式来管理项目依赖：经典模式 (Classic Mode) 和清单模式 (Manifest Mode)。

5.1 经典模式与清单模式对比

特性经典模式清单模式
配置文件无专用配置文件vcpkg.json
依赖范围全局安装到 vcpkg 实例项目本地安装
依赖声明使用命令行安装在 vcpkg.json 中声明
版本控制难以实现通过 builtin-baseline 可锁定版本
团队协作需手动同步环境将配置文件加入版本控制即可
推荐用途个人开发团队项目

5.2 经典模式 (Classic Mode)

这是 vcpkg 最初的工作方式。您需要手动在 vcpkg 实例中安装库，然后在 CMake 中查找它们。

  1. 安装库:
    在终端中，使用 vcpkg install 命令安装您需要的库。需要指定库名和目标 Triplet（除非设置了 VCPKG_DEFAULT_TRIPLET）。

    # Windows PowerShell 示例
# 安装 fmt 库，用于 64 位 Windows 静态链接
vcpkg install fmt:x64-windows

# 安装 boost 库，使用默认 Triplet
vcpkg install boost

# 安装多个库
vcpkg install zlib eigen3 nlohmann-json

    vcpkg 会将安装的库放置在其根目录下的 installed 文件夹中（按 Triplet 分隔）。

📝 注意： 安装格式为 <库名>:<triplet>，如果省略 :<triplet> 部分，则使用默认 Triplet

  1. 在 CMakeLists.txt 中查找库:
    确保您的 CMake 配置使用了 vcpkg 工具链文件（见 章节 4.1）。然后在 CMakeLists.txt 中使用 find_package 命令。
    # filepath: <your-project>/CMakeLists.txt
cmake_minimum_required(VERSION 3.15) # 推荐使用较新版本
project(MyAwesomeProject LANGUAGES CXX)

# vcpkg 工具链会自动处理查找路径，只需调用 find_package
find_package(fmt CONFIG REQUIRED)
find_package(Boost REQUIRED COMPONENTS system filesystem) # 查找 Boost 特定组件

add_executable(my_app main.cpp)

# 链接库
target_link_libraries(my_app PRIVATE fmt::fmt Boost::system Boost::filesystem)

经典模式的缺点:

  • 依赖关系不直观，未在项目代码中明确声明。
  • 需要手动管理 vcpkg 实例中的库安装。
  • 团队协作时，需要确保所有成员的 vcpkg 环境一致。
  • 不利于构建可复现性。

5.3 清单模式 (Manifest Mode - 推荐)

清单模式是现代且推荐的使用方式。它允许您在项目根目录下的 vcpkg.json 文件中声明项目依赖，vcpkg 会根据此文件自动安装和管理所需的库。

  1. 启用清单模式:
    只需在项目根目录下创建一个 vcpkg.json 文件即可。您可以使用命令快速开始：

    # 在项目根目录下运行
vcpkg new --application # 对于可执行文件项目
# 或
vcpkg new --library # 对于库项目

    这会创建一个基础的 vcpkg.json 和一个可选的 vcpkg-configuration.json 文件。

  2. 编辑 vcpkg.json 声明依赖:
    手动编辑 vcpkg.json 或使用 vcpkg add port 命令添加依赖。

    {
  "$schema": "https://raw.githubusercontent.com/microsoft/vcpkg-tool/main/docs/vcpkg.schema.json",
  "name": "my-awesome-project",
  "version": "0.1.0",
  "dependencies": [
    "fmt",
    {
      "name": "boost",
      "features": ["system", "filesystem"]
    },
    {
      "name": "eigen3",
      "version>=": "3.4.0"
    },
    {
      "name": "openssl",
      "platform": "windows | linux"
    }
  ],
  "builtin-baseline": "a1b2c3d4e5f6..."
}

    vcpkg.json 字段说明：

    字段描述
    name项目名称，小写，允许使用连字符
    version项目版本
    dependencies项目依赖列表
    fmt简单依赖，直接使用包名
    boost 对象带特定组件的依赖，使用features字段指定需要的组件
    eigen3 对象指定最低版本要求，使用version>=字段
    openssl 对象特定平台依赖，仅在Windows或Linux上安装
    builtin-baseline锁定vcpkg官方仓库的某个提交状态，确保依赖版本一致性，应替换为实际的commit哈希

💡 提示： 要获取当前 vcpkg 的 commit hash 作为 builtin-baseline，可以在 vcpkg 目录中运行 git rev-parse HEAD

  1. 安装依赖:
    当 CMake 配置项目时（并且 CMAKE_TOOLCHAIN_FILE 指向 vcpkg），vcpkg 会自动读取 vcpkg.json 并安装其中声明的所有依赖项到项目本地的 vcpkg_installed 目录中。

    您也可以手动触发安装：

    # 在项目根目录下运行
vcpkg install

# 指定 Triplet
vcpkg install --triplet=x64-windows-static

  2. 在 CMakeLists.txt 中使用:
    与经典模式类似，只需使用 find_package 即可。CMake 会自动在 vcpkg_installed 目录中查找。

    # filepath: <your-project>/CMakeLists.txt
cmake_minimum_required(VERSION 3.18) # 清单模式推荐 CMake 3.18+
project(MyAwesomeProject LANGUAGES CXX)

# find_package 用法与经典模式相同
find_package(fmt CONFIG REQUIRED)
find_package(Boost REQUIRED COMPONENTS system filesystem)
find_package(Eigen3 REQUIRED)

add_executable(my_app main.cpp)

target_link_libraries(my_app PRIVATE fmt::fmt Boost::system Boost::filesystem Eigen3::Eigen)

  3. 依赖版本控制:
    有几种方法可以控制依赖版本：

    方法语法用途
    builtin-baseline"builtin-baseline": "commit-hash"锁定整个注册表的状态
    版本约束"version>=": "1.2.3"指定最低版本要求
    精确版本"version=": "1.2.3"要求特定版本
    版本范围"version>=": "1.0.0", "version<": "2.0.0"指定版本范围
    overlay-ports在 vcpkg-configuration.json 中配置使用自定义版本或补丁

    将 vcpkg.json 和（如果使用）vcpkg-configuration.json 添加到版本控制系统中。

5.4 清单模式的高级配置

以下是一个更复杂的 vcpkg.json 示例，演示了更多高级功能：

{
  "$schema": "https://raw.githubusercontent.com/microsoft/vcpkg-tool/main/docs/vcpkg.schema.json",
  "name": "advanced-project",
  "version": "1.0.0",
  "description": "一个使用vcpkg的高级C++项目",
  "homepage": "https://github.com/user/project",
  "license": "MIT",
  "supports": "!uwp & !(arm & windows)",
  "builtin-baseline": "50954bc17af551cc78f494c63df4b9e3ee1e6e3b",
  "dependencies": [
    {
      "name": "boost",
      "version>=": "1.80.0",
      "features": ["graph", "regex"],
      "platform": "!android"
    },
    {
      "name": "openssl",
      "version>=": "3.0.0",
      "platform": "windows"
    },
    {
      "name": "fmt",
      "version=": "9.1.0"
    },
    "nlohmann-json"
  ],
  "overrides": [
    {
      "name": "openssl", 
      "version": "3.0.7"
    }
  ],
  "features": {
    "gui": {
      "description": "启用GUI组件",
      "dependencies": [
        "qt5"
      ]
    },
    "tests": {
      "description": "包含测试",
      "dependencies": [
        "gtest"
      ]
    }
  }
}

高级配置字段说明：

字段描述
description项目描述
homepage项目主页
license项目许可证
supports支持的平台表达式，使用逻辑操作符定义支持条件
builtin-baseline指定vcpkg仓库的确切提交哈希
dependencies项目依赖的详细配置
overrides覆盖特定依赖的版本，优先级高于dependencies中的设置
features定义可选功能，每个功能可包含自己的依赖项
platform平台条件，指定依赖在哪些平台上安装
version=要求精确匹配的版本
version>=要求最低版本

5.5 清单模式的优势

优势说明
声明式依赖项目依赖在 vcpkg.json 中清晰可见
项目隔离依赖安装在项目本地 (vcpkg_installed)，不影响全局或其他项目
可复现构建通过 builtin-baseline 和版本约束，确保一致的依赖版本
易于协作将配置文件加入版本控制，团队成员自动获取相同依赖
按需安装CMake 配置时自动安装所需依赖
条件依赖通过 platform 和 features 实现条件依赖

6. 常见 Triplets

Triplet 定义了目标平台的架构、操作系统和链接方式（静态或动态）。您可以通过 vcpkg help triplet 查看所有支持的 Triplets。

6.1 Triplet 命名规则

一般格式为: <架构>-<操作系统>[-<链接方式>]

每个 Triplet 对应一个配置文件，位于 vcpkg 安装目录的 triplets/ 文件夹中。您也可以创建自定义 Triplet 文件。

6.2 常见 Triplet 对照表

下表列出了常见的 Triplet 及其特性：

🖥️ Windows (MSVC)
Triplet架构链接方式CRT 链接
x86-windows32 位静态链接库/MT (静态)
x64-windows64 位静态链接库/MT (静态)
x86-windows-static32 位静态链接库/MT (静态)
x64-windows-static64 位静态链接库/MT (静态)
x86-windows-static-md32 位静态链接库/MD (动态)
x64-windows-static-md64 位静态链接库/MD (动态)
x86-windows-release32 位动态链接库/MD (动态)
x64-windows-release64 位动态链接库/MD (动态)
arm64-windowsARM64静态链接库/MT (静态)
🐧 Linux
Triplet架构链接方式
x64-linux64 位静态链接 (通常)
x64-linux-dynamic64 位动态链接
arm64-linuxARM64静态链接
🍎 macOS
Triplet架构链接方式
x64-osx64 位 Intel静态链接
arm64-osx64 位 Apple Silicon静态链接
x64-osx-dynamic64 位 Intel动态链接
arm64-osx-dynamic64 位 Apple Silicon动态链接
📱 Android
Triplet架构
arm64-androidARM64
x64-androidx86_64
🪟 Windows (MinGW)
Triplet架构链接方式
x64-mingw-dynamic64 位动态链接
x64-mingw-static64 位静态链接

6.3 选择合适的 Triplet

选择 Triplet 时，需考虑以下因素：

  1. 目标架构：您的程序将在哪种CPU架构上运行（x86、x64、ARM等）
  2. 操作系统：目标平台的操作系统
  3. 链接方式：
    • 静态链接：将库代码直接编译到您的可执行文件中，生成较大的可执行文件，但部署更简单
    • 动态链接：依赖于运行时存在的共享库（DLL或.so文件），生成较小的可执行文件，但部署需要包含相应的共享库

💡 提示： 对于需要分发的应用程序，静态链接通常更容易部署；对于开发环境，动态链接通常能加快构建速度。

7. 总结与最佳实践

下表总结了使用 vcpkg 时的关键最佳实践：

最佳实践说明
优先使用清单模式使用 vcpkg.json 进行依赖管理，获得更好的项目隔离和可复现性
使用 CMake Presets在 VSCode 中使用 CMakePresets.json 或 CMakeUserPresets.json 配置 CMAKE_TOOLCHAIN_FILE
配置工作区设置利用 .vscode/settings.json 为集成终端配置项目特定的环境变量
版本控制关键文件将 vcpkg.json 和 CMakePresets.json 添加到版本控制系统
理解 Triplets根据目标平台和链接需求选择合适的 Triplet
定期更新运行 git pull 和 bootstrap 脚本更新 vcpkg，更新 builtin-baseline 升级依赖

通过遵循本指南，您可以有效地利用 vcpkg 来管理 C++ 项目的依赖，简化开发流程并提高项目的健壮性。如需更深入的信息，请查阅 vcpkg 官方文档。

8. 常见问题解答 (FAQ)

8.1. 一般问题

Q: vcpkg 是否可以与其他包管理器一起使用？
A: 是的，vcpkg 可以与 Conan、CMake FetchContent 等其他包管理解决方案并行使用，但需注意管理潜在的冲突。

Q: 能否使用私有库或企业内部库？
A: 是的，vcpkg 支持自定义注册表。在 vcpkg-configuration.json 中配置私有 Git 存储库或本地路径作为附加注册表。

8.2. 安装和配置问题

Q: 如何修复 “vcpkg 不是内部或外部命令” 错误？
A: 确保 vcpkg 路径已添加到环境变量 PATH 中，或使用绝对路径调用 vcpkg.exe。

Q: 在全局安装和项目级安装之间应如何选择？
A: 对于团队项目，建议以 Git 子模块方式将 vcpkg 添加到项目中；对于个人开发，可以使用全局安装的 vcpkg。

8.3. 构建和依赖问题

Q: 如何解决依赖版本冲突？
A: 在 vcpkg.json 中使用版本约束条件 ("version>=": "x.y.z") 和 overlay-ports 解决版本冲突。

Q: 如何降低 vcpkg 安装库的时间？
A: 考虑使用 Binary Caching 功能，配置 VCPKG_BINARY_SOURCES 环境变量指向本地或远程缓存位置。

8.4. CMake 集成问题

Q: 为什么 CMake 找不到 vcpkg 安装的库？
A: 检查 CMAKE_TOOLCHAIN_FILE 是否正确设置，确认是否使用了正确的 Triplet，并检查库是否已安装成功。

Q: 如何在 CMake 中指定特定的 Triplet？
A: 设置 VCPKG_TARGET_TRIPLET CMake 变量，或使用 VCPKG_DEFAULT_TRIPLET 环境变量。

9. 快速入门指南

如果您需要快速开始使用 vcpkg，请按照以下步骤操作：

  1. 克隆 vcpkg 并引导安装

    git clone https://github.com/microsoft/vcpkg.git
cd vcpkg
.\bootstrap-vcpkg.bat

  2. 创建项目并添加清单文件

    mkdir MyProject
cd MyProject
# 创建简单的 vcpkg.json 文件   @'
{
  "name": "my-project",
  "version": "0.1.0",
  "dependencies": [
    "fmt",
    "nlohmann-json"
  ]
}
'@ > vcpkg.json

  3. 创建 CMake 配置

    {
  "version": 3,
  "configurePresets": [
    {
      "name": "default",
      "generator": "Ninja",
      "binaryDir": "${sourceDir}/build",
      "cacheVariables": {
        "CMAKE_TOOLCHAIN_FILE": "../vcpkg/scripts/buildsystems/vcpkg.cmake"
      }
    }
  ]
}
'@ > CMakePresets.json

  4. 创建 CMakeLists.txt

    @'
cmake_minimum_required(VERSION 3.15)
project(MyProject LANGUAGES CXX)

set(CMAKE_CXX_STANDARD 17)

find_package(fmt CONFIG REQUIRED)
find_package(nlohmann_json CONFIG REQUIRED)

add_executable(myapp main.cpp)
target_link_libraries(myapp PRIVATE fmt::fmt nlohmann_json::nlohmann_json)
'@ > CMakeLists.txt

  5. 创建示例代码

    @'
#include <fmt/core.h>
#include <nlohmann/json.hpp>
#include <iostream>

int main() {
    nlohmann::json data = {{"name", "vcpkg"}, {"version", "2025"}};
    fmt::print("Hello from vcpkg! JSON data: {}\n", data.dump(2));
    return 0;
}
'@ > main.cpp

  6. 配置和构建

    cmake --preset=default
cmake --build ./build

  7. 运行程序

    ./build/myapp

通过以上步骤，您已经创建了一个使用 vcpkg 管理依赖的简单 C++ 项目！

AetherByte
关注
如何安装vcpk
安徽锐锋科技-沐雨潇竹
07-14 1762
打开一个命令行终端（如：Windows 的命令提示符或 PowerShell，或者 Linux/Mac 的终端）。VCPKG 官方教程：https://vcpkg.io/en/getting-started。要安装 3fd 库，首先你需要安装 vcpkg 包管理器。克隆 vcpkg 存储库到本地目录中。根据你的系统和网络连接速度，此过程可能需要一些时间来下载和安装所需的库和依赖项。原始库的官方地址：https://vcpkg.io/en/packages。安装完成后，你可以使用 3fd 库进行开发。
Vcpkg安装
qq_34517855的博客
03-04 2386
在windows10系统下安装vcpkg，并集成到VS2022
C++一键安装工具(vcpkg)
lovely_yoshino的博客
06-28 1万+
相较于python而言，C++因为其复杂的环境安装一直受到很多人的诟病，比如说一个pcl的安装就需要有很多操作步骤。译过程仍然复杂和多样化。当了解了这些还不够，我们还需要考虑预先编译出哪种类型的开源库程序。比如：Debug还是Release、动态库还是静态库、MD还是MT、32位还是64位。常见的编译方式就有下面四种：为了解决这样的问题，微软C++ 团队开发了适用于C 和C++ 库的跨平台开源软件包管理器，它大大简化了Windows、Linux 和macOS 上第三方库相关的下载和配置操作。
windows 下包管理工具vcpkg安装
yuanshenqiang的博客
10-26 7061
vcpkg包管理工具安装
vcpkg 安装 使用技巧 (详细-建议收藏)
最新发布
qq_40685088的博客
02-19 990
• 在 CMake 项目中使用 vcpkg 管理的库，需要在 CMake 配置中添加 vcpkg 的工具链文件。• 确保你的系统已经安装了必要的编译器和工具，例如在 Windows 上安装 Visual Studio 的 MSVC 编译器。为了能够更方便地使用 vcpkg 命令，可以将 vcpkg 的安装目录添加到系统环境变量 Path 中。• 在使用 vcpkg 时，可能会遇到网络问题导致下载库失败。• 在变量值中添加 vcpkg 的安装路径，例如`D:\vcpkg\vcpkg\scripts`。
安装使用vcpkg的简易教程
na 小子叫坚强的博客
10-28 6436
简易安装使用vcpkg，并下载安装三方库进行使用
vcpkg的安装、使用以及集成
qq_42838399的博客
11-11 4883
在右上角的 “程序包源” 中选择刚刚设置的 “vcpkg”。” 选择 vcpkg 目录，然后点击右侧的“更新按钮”。导出参数格式：–raw 以不打包的目录格式导出，–nuget 以 nuget 包形式导出，–zip 以 zip 压缩包形式导出，–7zip 以 7z 压缩包形式导出。如果要安装的库依赖别的库，不用担心，vcpkg会进行依赖关系检查（比如编译 libcurl，会自动下载 zlib、openssl 进行编译）。如果要安装编译某一个架构的开源库，在需要安装的库后面指定相应的 triplet 即可。
C++开源库 - 包管理工具Vcpkg安装使用教程
lhw330472787的博客
07-11 930
C++开源库 - 包管理工具Vcpkg安装使用教程
vcpkg安装和使用——windows篇
qq625924821的博客
01-09 6015
vcpkg安装和使用
Vcpkg 的安装与使用
叹世界
11-27 8902
Vcpkg 的安装与使用
c#源码转java源码的-vcpkg:适用于Windows，Linux和MacOS的C++库管理器
05-19
Vcpkg可帮助您在Windows，Linux和MacOS上管理C和C ++库。 该工具和生态系统在不断发展，我们始终感谢您的贡献！ 如果您以前从未使用过vcpkg，或者您想弄清楚如何使用vcpkg，请查看我们的部分，了解如何开始使用vcpkg...
vcpkg 文档 vcpkg是一款免费的C/C++包管理器，用于获取和管理库 从1500多个开源库中进行选择，只需一步即可下载和
07-20
- **定义**: vcpkg 是一款由微软及其 C++ 社区共同维护的免费且开源的 C/C++ 包管理器。 - **历史背景**: 该项目自 2016 年启动以来，一直致力于帮助开发者将其项目迁移至新版的 Visual Studio。 - **跨平台特性**: ...
Vcpkg：Visual Studio下C++库管理器
- **包管理**：vcpkg使用包的概念来管理各种C++库。每个包是预编译的，或者由vcpkg从源代码构建而成，包的源可以是官方的源代码仓库，也可以是其他可信赖的源。 - **配置和优化**：vcpkg还提供了对包的配置选项，...
Vcpkg在C++跨平台开发中的应用与安装指南
标题 "vcpkg-master.zip" 揭示了这与 Microsoft 的 vcpkg 有关，vcpkg 是一个用于 C++ 的包管理器，用于在开发环境中管理开源库，让开发者能够更容易地安装和使用各种开源 C++ 库。通过 vcpkg，开发者可以为不同的...
C++跨平台开发中的依赖管理：包管理器使用与最佳实践指南
[C++跨平台开发中的依赖管理：包管理器使用与最佳实践指南](https://ask.qcloudimg.com/http-save/8927754/61382d16d920db65b8f14d4ae720d6b6.png) # 1. C++跨平台开发概述 随着软件开发行业的日益全球化，开发者们...
vcpkg 安装和配置指南
gitblog_07017的博客
09-13 959
vcpkg 安装和配置指南 vcpkg vcpkg - 一个用于管理 C 和 C++ 库的工具，支持在 Windows、Linux 和 macOS 上安装和集成各种库。 项目地址: https://gitcode.com/gh_m...
Vcpkg使用教程
qq_45152711的博客
11-27 2440
安装一个库：卸载一个库：更新所有库vcpkg list：列出已安装的库：搜索库：将 Vcpkg 集成到 Visual Studio 中。
vcpkg安装和使用--学习入门
热门推荐
weixin_44210987的博客
11-26 4万+
【1】安装 （1）先git clone下载下来vcpkg文件夹。 （2）双击bootstrap-vcpkg.bat 跳出来窗口，等待跑完，自动关闭。 （3）在文件夹右键-
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值