在Visual Studio中使用包管理工具vcpkg进行项目级集成

在 Visual Studio 中使用 vcpkg 进行 项目级集成（而非全局集成）是一种更可控的依赖管理方式，尤其适合团队协作或需要隔离依赖版本的项目。（PS：结合CMake更好用，参考官方文档）以下是详细的分步指南，涵盖从初始化配置到最终运行的完整流程：

---

1. 初始化项目级 vcpkg 环境

(1) 在项目根目录生成 vcpkg.json 和 vcpkg-configuration.json

运行以下命令，将 vcpkg 配置绑定到当前项目：

# 进入项目目录（包含 .sln 或 .vcxproj 的目录）
cd path\to\your\project

# 生成项目级配置文件（需 vcpkg 2022 或更高版本）
vcpkg new --application

生成的文件：

• vcpkg.json：声明项目依赖（类似 package.json）。
• vcpkg-configuration.json：配置 vcpkg 的注册表或覆盖项。

---

(2) 添加依赖包

使用 vcpkg add port 添加需要的库（如 jsoncpp）：

vcpkg add port jsoncpp

这会自动更新 vcpkg.json，添加如下内容：

{
  "dependencies": 
  		["jsoncpp"]
}

---

2. 安装依赖

(1) 安装依赖库

在项目目录下运行：

vcpkg install

vcpkg 会：

1. 读取 vcpkg.json 中的依赖。
2. 下载并编译库，生成的文件默认存放在：
   • 头文件：vcpkg_installed\x64-windows\include
   • 库文件：vcpkg_installed\x64-windows\lib
   • DLL：vcpkg_installed\x64-windows\debug\bin（Debug）或 vcpkg_installed\x64-windows\bin（Release）

---

3. 配置 Visual Studio 项目

(1) 添加包含路径和库路径

在 项目属性 中配置：

1. VC++ 目录 → 包含目录：

   $(SolutionDir)vcpkg_installed\x64-windows\include
   

2. VC++ 目录 → 库目录（静态库）：

   $(SolutionDir)vcpkg_installed\x64-windows\lib
   

(2) 链接库文件

在 链接器 → 输入 → 附加依赖项 中添加：

• Debug 模式：jsoncpp.lib（或 jsoncppd.lib 如果存在）
• Release 模式：jsoncpp.lib

---

4. 处理运行时依赖（DLL 文件）

(1) 手动复制 DLL

将所需的 DLL 从 vcpkg 目录复制到项目输出目录：

• Debug 模式：

  copy "$(SolutionDir)vcpkg_installed\x64-windows\debug\bin\*.dll" "$(SolutionDir)x64\Debug\"
  

• Release 模式：

  copy "$(SolutionDir)vcpkg_installed\x64-windows\bin\*.dll" "$(SolutionDir)x64\Release\"
  

(2) 自动化脚本（可选）

在 生成后事件 中自动复制 DLL：

1. 右键项目 → 属性 → 生成事件 → 生成后事件。
2. 添加命令行：

   xcopy /y "$(SolutionDir)vcpkg_installed\x64-windows\debug\bin\*.dll" "$(OutDir)"
   

---

5. 验证集成

(1) 代码测试

在项目中包含头文件并测试：

#include <json/json.h>
#include <iostream>

int main() {
    Json::Value root;
    root["message"] = "Hello from vcpkg!";
    std::cout << root.toStyledString() << std::endl;
    return 0;
}

(2) 检查输出

• 编译应无报错。
• 运行程序时，确保 jsoncpp.dll 位于 x64\Debug\ 或 x64\Release\ 目录。

---

6. 32 位（x86）配置

若需支持 32 位，重复上述步骤，替换 x64-windows 为 x86-windows：

1. 安装依赖：

   vcpkg install jsoncpp:x86-windows
   

2. 项目属性中修改路径：
   • 包含目录：$(SolutionDir)vcpkg_installed\x86-windows\include
   • 库目录：$(SolutionDir)vcpkg_installed\x86-windows\lib
3. 复制 DLL：

   copy "$(SolutionDir)vcpkg_installed\x86-windows\debug\bin\*.dll" "$(SolutionDir)x86\Debug\"
   

---

7. 常见问题解决

问题	解决方案
找不到头文件	检查 vcpkg_installed\include 路径是否正确，确保平台（x64/x86）匹配。
链接错误（LNK2019）	确认库文件名（如 jsoncpp.lib）是否正确，Debug/Release 配置是否匹配。
DLL 缺失	检查 DLL 是否复制到输出目录，或添加 vcpkg_installed\bin 到 PATH 环境变量。

---

总结

通过 项目级 vcpkg 集成，你可以：

1. 隔离依赖：每个项目独立管理库版本。
2. 简化协作：vcpkg.json 可提交到版本控制，确保团队一致。
3. 灵活配置：支持 x86/x64、Debug/Release 多平台。

关键步骤：