vcpkg安装需先克隆仓库并运行bootstrap脚本生成可执行文件，再设VCPKG_ROOT环境变量；CMake中必须在project()前用$ENV{VCPKG_ROOT}设置CMAKE_TOOLCHAIN_FILE，且find_package名称须与port导出名一致。
vcpkg 安装和在 CMake 中引用开源库，核心就两点：**先让 vcpkg 可用，再让 CMake 知道它在哪**。跳过所有“为什么”铺垫，直接说怎么做、为什么必须这么写、哪里最容易出错。
安装 vcpkg 并初始化可执行文件
不是下载一个 .exe 就完事——vcpkg 是源码构建的工具，必须本地编译一次才能生成可运行的 vcpkg.exe（Windows）或 vcpkg（Linux/macOS）。
- 克隆仓库到路径简单、无空格、无中文的目录，比如
C:\vcpkg或~/vcpkg - 进目录后直接运行：
.\bootstrap-vcpkg.bat（Windows）或./bootstrap-vcpkg.sh（Linux/macOS） - 完成后会生成
vcpkg.exe，此时可执行vcpkg --version验证 - 不建议把
vcpkg放进系统 PATH；更稳妥的是设环境变量VCPKG_ROOT指向该目录，后续 CMake 和命令行都靠它定位
安装库必须指定 triplet，否则默认 x86-windows 会踩坑
Windows 下不显式指定 triplet，vcpkg install 默认走 x86-windows（32 位），但你的项目大概率是 x64-windows。链接时会报 LNK2038: mismatch detected for 'MachineType' 这类错误。
CMake 4.3.2
下载
CMake 4.3.2 Windows x86_64 历史版本安装包，适合旧项目兼容、构建环境回退、CMakeLists.txt 迁移验证、Visual Studio/Ninja/Makefile 生成器测试和 C/C++ 项目维护。
- 查当前支持的 triplet：
vcpkg help triplet - 装库时必须带后缀，例如：
vcpkg install sqlite3:x64-windows、vcpkg install boost:x64-windows-static - 静态链接加
-static，动态链接用-dynamic；混用会导致 ABI 不兼容，find_package()找不到目标或链接失败 - 如果要用
curl[openssl]这类带特性（feature）的包，确保先运行vcpkg install curl[openssl]:x64-windows，否则find_package(curl CONFIG)会失败
CMakeLists.txt 中必须在 project() 前设置 CMAKE_TOOLCHAIN_FILE
这是最常被忽略的致命点：CMAKE_TOOLCHAIN_FILE 必须在 project() 调用之前设置，否则 vcpkg.cmake 工具链根本不会生效，find_package() 依然去系统路径里找，而不是 vcpkg 安装的库。
- 正确写法（顺序不能换）：
set(CMAKE_TOOLCHAIN_FILE "$ENV{VCPKG_ROOT}/scripts/buildsystems/vcpkg.cmake")project(MyApp) - 不要写成
set(CMAKE_TOOLCHAIN_FILE "${VCPKG_ROOT}/...")——${VCPKG_ROOT}是 CMake 变量，但此时VCPKG_ROOT还没从环境变量读进来，得用$ENV{VCPKG_ROOT} - 如果用 CMake Presets（推荐），在
CMakePresets.json里配："CMAKE_TOOLCHAIN_FILE": "$env{VCPKG_ROOT}/scripts/buildsystems/vcpkg.cmake" - 配置命令示例：
cmake -B build -S . -DCMAKE_TOOLCHAIN_FILE="$env:VCPKG_ROOT/scripts/buildsystems/vcpkg.cmake"（PowerShell）
find_package() 的名字不一定等于包名，要看 port 的 export 配置
比如装了 sqlite3:x64-windows，但 find_package(sqlite3 REQUIRED) 很可能失败——因为该 port 导出的是 unofficial-sqlite3，不是 sqlite3。
- 安装后看终端输出最后一段，例如：
The package sqlite3:x64-windows provides CMake targets: find_package(unofficial-sqlite3 CONFIG REQUIRED) - 或者进
$VCPKG_ROOT/installed/x64-windows/share/目录，找对应子目录下的xxx-config.cmake文件名 - Boost 是个例外：
find_package(Boost REQUIRED)可以直接用，但必须确保安装时用了boost:x64-windows，且 CMakeLists 中没漏掉set(Boost_USE_STATIC_LIBS ON)这类控制变量 - Qt5/Qt6 更麻烦：装的是
qt5-base:x64-windows，但find_package(Qt5 COMPONENTS Widgets REQUIRED)才对；Qt6 同理，用find_package(Qt6 COMPONENTS Widgets REQUIRED)
CMAKE_TOOLCHAIN_FILE 的时机、triplet 的一致性、find_package() 名称的匹配，三者任一出错都会静默失败或链接报错。别依赖“看起来能跑”，每次换 triplet 或升级 vcpkg 后，务必检查 cmake --build build --verbose 输出里是否真加载了 vcpkg 提供的 target。 
