优先使用 vcpkg integrate install 全局集成，无需手动配路径、改属性或复制文件，VS2022 自动按项目平台（如x64-Debug）注入头文件、库路径及链接项，实现开箱即用。
vcpkg integrate install 全局集成**。这是 VS2022 下最省事、最稳定、最接近“开箱即用”的方式，尤其适合快速验证、教学、原型开发或团队统一环境。
为什么 vcpkg integrate install 是首选
它不是“装个工具”，而是让 VS 自动把所有已安装的 vcpkg 库（比如 spdlog、fmt、jsoncpp）的头文件路径、库路径、链接项，按当前项目配置（x64-Debug / x86-Release 等）实时注入到 MSBuild 中。你新建一个空 C++ 项目，#include <spdlog/spdlog.h> 就能直接编译通过，零额外配置。
常见错误现象：
– 手动在项目属性里填了 Additional Include Directories 却漏了 Additional Library Directories 或 Additional Dependencies
– 复制了别人项目的 .vcxproj，但没同步 vcpkg 安装的 triplet（如 x64-windows），导致链接时找不到 xxx.lib
– 用 MT 编译的库，项目却设成 MD，出现 LNK2038 运行时库不匹配
-
vcpkg integrate install自动处理 triplet 对齐，避免架构/运行时错配 - 不依赖环境变量，不污染系统 PATH，对多项目共存友好
- 卸载库只需
vcpkg remove xxx，VS 侧无需任何操作
vcpkg install 后还要指定 triplet 吗
要，而且必须显式指定，否则默认是 x86-windows（32 位），而 VS2022 新建项目默认平台是 x64。
典型错误现象：
– vcpkg install spdlog 完后，在 x64 项目里 #include 没报错，但链接时报 LNK1104：无法打开“spdlog.lib”
– vcpkg list 输出为空，或只显示 xxx:x86-windows
- 查当前项目平台：右键项目 → 属性 → 常规 → 平台 → 看是
x64还是Win32 - 装库时必须带 triplet：
vcpkg install spdlog:x64-windows - 若需同时支持多平台，分别安装：
vcpkg install spdlog:x64-windows spdlog:x86-windows - 全局集成后，VS 会自动选对应平台的 installed 树，无需在项目里再选
什么时候不能用 integrate install，得回退到手动配置
两种真实场景下它会失效：
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
– 项目用了 CMake + find_package()，且未启用 vcpkg 的 CMake 工具链支持
– 项目需要混合使用 vcpkg 库和你自己编译的静态库（比如 libmycore.a），而该库是用 MT 编译的，但 vcpkg 默认用 MD
- 前者需改 CMakeLists.txt，加
-DCMAKE_TOOLCHAIN_FILE=[path]/vcpkg/scripts/buildsystems/vcpkg.cmake - 后者需给 vcpkg 指定自定义 triplet，例如复制
scripts/triplets/x64-windows.cmake改成x64-windows-static.cmake，把VCPKG_CRT_LINKAGE设为static，再vcpkg install xxx:x64-windows-static - 注意：
integrate install不处理自定义 triplet，必须用 manifest 模式或 CMake 工具链
容易被忽略的关键点
不是装完 vcpkg 就万事大吉。最容易卡住的地方其实是：VS 没刷新缓存，或用了旧的构建系统。
立即学习“C++免费学习笔记（深入）”；
- 执行
vcpkg integrate install后，必须重启 Visual Studio（不是仅关闭解决方案） - 确认项目属性页里“配置属性 → 常规 → 继承的项目设置”中包含
vcpkg相关条目（如vcpkg_x64-windows） - 如果项目是老版本（.vcproj 或早期 .vcxproj），可能不兼容 vcpkg 的 MSBuild 集成，建议新建空项目迁移源码
-
vcpkg安装的库默认是动态链接（MD），如果你项目设成了MT，哪怕头文件能找到，链接也必失败 —— 这个不报“找不到头文件”，而是报一堆 LNK2019，非常隐蔽
