vcpkg integrate install 是首选方案，因它使VS2022新建项目自动识别库路径，避免手动配置Include/Library目录及依赖项导致的LNK2019、C1083等错误，且按平台/配置自动映射工具链目录，干净可逆。
直接用 vcpkg 集成，别手动配路径、别建 .props 文件——除非你有跨团队绝对路径强约束或遗留项目必须兼容旧构建流程。
为什么 vcpkg integrate install 是首选方案
Visual Studio 2022 默认支持 vcpkg 全局集成，执行一次 .\vcpkg.exe integrate install 后，所有新建项目自动识别已安装库的头文件和链接库路径。它绕过了传统方式里最易出错的三步：手动填 Include Directories、Library Directories、Additional Dependencies。
常见错误现象包括：LNK2019: unresolved external symbol（链接器找不到 lib）、C1083: Cannot open include file（头文件路径错）。这些几乎全是路径配置漏项或平台不匹配导致的——而 vcpkg 的集成会按当前项目的 Platform（x64 / Win32）和 Configuration（Debug / Release）自动映射到对应工具链目录（如 installed\x64-windows\include），无需人工干预。
- 只对新项目生效；已有项目需手动启用：右键项目 →
Properties→General→Project Defaults→Use of vcpkg设为Yes - 不改变项目文件（.vcxproj），只注入 MSBuild 导入逻辑，干净可逆
- 若项目使用 CMake，应改用
vcpkg的 CMake 工具链模式（-DCMAKE_TOOLCHAIN_FILE=.../scripts/buildsystems/vcpkg.cmake），而非全局集成
vcpkg install 命令必须带工具链后缀
安装库时漏写工具链是高频翻车点。例如 .\vcpkg.exe install opencv 不会报错，但实际什么也没装进 installed 目录；正确命令是 .\vcpkg.exe install opencv:x64-windows。
工具链决定编译目标，也决定后续能否被 VS 项目加载：
Visual Studio 18.8.1 官方固定版本安装引导程序，当前条目使用微软发布历史中的 Professional Web Installer，适合旧项目兼容、环境回退、复现特定构建链和排查版本差异等场景。
-
x64-windows→ 对应 VS 中Platform = x64的项目 -
x86-windows→ 对应Win32平台，不是x64下的子集，二者 ABI 不兼容 - 混合使用会导致
LNK2038: mismatch detected for 'RuntimeLibrary'等链接时崩溃 - 若需同时支持多平台，必须分别执行安装：先
install xxx:x64-windows，再install xxx:x86-windows
运行时 DLL 路径问题不能靠环境变量硬塞
VS 调试时提示 The program can't start because xxx.dll is missing，很多人习惯在项目属性 → Debugging → Environment 里加 PATHEXT=... 或拼接一堆 $(VCPKG_ROOT)\installed\x64-windows\bin。这看似能跑，但埋下三个坑：
- 路径写死，换机器或重装
vcpkg就失效 - 多个库的
bin目录顺序错乱，可能加载到低版本 DLL - 发布时仍需手动拷 DLL，没解决根本问题
更可靠的做法是：在项目属性 → Linker → General → Output File 中确认输出路径（如 $(OutDir)$(TargetFileName)），然后把对应工具链的 bin 目录（如 installed\x64-windows\bin）里的 DLL 全部复制到该输出目录。可用 Post-Build Event 自动化：
xcopy "$(VCPKG_ROOT)\installed\x64-windows\bin\*.dll" "$(OutDir)" /Y
注意：$(VCPKG_ROOT) 需提前在 VS 中定义为用户宏（Property Manager → User Macros），值设为你的 vcpkg 安装路径。
静态链接与运行时库（MT/MD）必须全链路一致
第三方库默认按 MD（动态链接运行时）编译，如果你的项目设为 MT（静态链接），链接时必然失败。检查点有三个：
- 项目属性 →
C/C++ → Code Generation → Runtime Library：确认是MDd（Debug）或MD（Release） -
vcpkg安装时加--triplet指定静态版（如x64-windows-static），否则它不会生成MT版本 - 某些库（如
openssl）默认禁用静态编译，需额外传--overlay-ports或改 portfile
最容易被忽略的是：哪怕你只用一个头文件库（如 nlohmann/json），只要它内部用了 STL 容器，其 ABI 就依赖运行时库类型。混用 MT 和 MD 在 Debug 下可能暂时不崩，Release 下必现 heap corruption 或随机 crash。
