vcpkg需克隆源码并自举构建vcpkg.exe，不提供预编译安装包；install命令默认仅构建x64-windows triplet且不自动集成，须显式指定triplet、执行integrate或配置CMAKE_TOOLCHAIN_FILE才能被项目识别。
Windows 上用 vcpkg 管理 C++ 第三方库，不是“安装工具”而是“克隆 + 自举构建”，没有传统意义上的安装包或全局注册表写入。
怎么获取并初始化 vcpkg
官方不提供预编译二进制安装程序，必须从 GitHub 克隆源码并自行构建引导程序 vcpkg.exe：
- 打开 PowerShell 或 CMD（**以管理员身份非必需，但建议避免路径含空格或中文**）
- 执行：
git clone https://github.com/Microsoft/vcpkg.git - 进入目录：
cd vcpkg - 运行自举：
.\bootstrap-vcpkg.bat（Windows）或./bootstrap-vcpkg.sh（Linux/macOS）
成功后当前目录下会生成可执行文件 vcpkg.exe，它就是核心管理器。无需“安装”，也**不建议移动或复制该文件到系统 PATH**——后续集成 Visual Studio 或 CMake 时，路径需指向这个具体目录。
vcpkg install 命令的常见误用场景
vcpkg install 默认只构建 x64-windows 三元组（triplet），且不自动链接到项目，容易误以为“装完就能用”：
立即学习“C++免费学习笔记（深入）”；
- 想装其他平台？必须显式指定 triplet：
vcpkg install zlib:x86-windows、vcpkg install opencv:arm64-windows - 要支持静态链接？用
vcpkg install xxx:x64-windows-static（注意后缀-static，不是开关参数） - 装完库不会自动出现在
#include路径或链接器输入里——必须通过vcpkg integrate install注入 Visual Studio，或在 CMake 中启用VCPKG_TOOLCHAIN - 重复运行
vcpkg install同一包不会报错，但也不会跳过已构建版本；若想强制重装，加--recurse或先vcpkg remove xxx
如何让 CMakeLists.txt 正确识别 vcpkg 包
CMake 不会自动发现 vcpkg，必须显式告知工具链路径，否则 find_package() 会失败：
- 调用 CMake 时必须传入：
cmake -B build -S . -DCMAKE_TOOLCHAIN_FILE=[vcpkg-root]/scripts/buildsystems/vcpkg.cmake -
[vcpkg-root]是你克隆后执行bootstrap-vcpkg.bat的那个目录，不能是子目录或快捷方式路径 - 如果 CMake 报错
Could not find a package configuration file，大概率是CMAKE_TOOLCHAIN_FILE路径错、拼写错，或没加引号导致空格截断 - 使用
find_package(Boost REQUIRED)时，确保已执行过vcpkg install boost，且 triplet 与 CMake 构建目标一致（如都用x64-windows）
为什么 vcpkg list 显示已安装，但项目仍编译失败
vcpkg list 只说明该 triplet 下包已构建完成，不代表头文件/库能被当前构建环境访问：
- Visual Studio 用户必须运行
vcpkg integrate install（一次即可），否则 MSBuild 不知道头文件位置 - CMake 用户若忘记传
-DCMAKE_TOOLCHAIN_FILE，find_package会退回到系统路径查找，和 vcpkg 无关 - 不同 triplet 的库完全隔离：装了
zlib:x86-windows，不代表x64-windows项目能用；CMake 构建 x64 目标却用了 x86 的 toolchain，也会链接失败 - vcpkg 默认构建动态库（DLL），若项目设为 /MT（静态 CRT），需改用
-statictriplet，否则出现 LNK2038 运行时库不匹配
最常被忽略的一点：vcpkg 的 triplet 不只是架构标识，它还隐含了 CRT 类型、链接方式、甚至 Windows SDK 版本。换 triplet 就等于换一套 ABI，不能混用。
