vcpkg manifest 模式是 vcpkg 自2021年起主推的现代依赖管理方式，通过项目根目录的vcpkg.json声明依赖，支持版本锁定（vcpkg-lock.json），使依赖与项目强绑定，避免构建不一致。
什么是 vcpkg manifest 模式
vcpkg manifest 模式是 vcpkg 从 2021 年起主推的现代依赖管理方式，核心就是靠项目根目录下的 vcpkg.json 文件声明依赖，不再需要手写 vcpkg install xxx 或维护 vcpkg integrate install 的全局注册。它让依赖和项目绑定得更紧，也支持 lockfile（vcpkg-lock.json）锁定版本，避免 CI 或不同机器上构建结果不一致。
怎么初始化一个带 manifest 的 C++ 项目
确保你已安装较新版本的 vcpkg（建议 ≥ 2023.03.09），且已执行过 vcpkg bootstrap。然后在你的 C++ 项目根目录下运行：
vcpkg create project --manifest
或者手动创建 vcpkg.json，内容类似：
{
"name": "myapp",
"version-string": "0.1.0",
"dependencies": [
"fmt",
{
"name": "boost-system",
"features": ["locale"]
}
]
}
-
name必须与项目名一致（CMake 中project()名最好也匹配） - 每个 dependency 可以是字符串（简写）或对象（支持
features、platform、host等） - 不写
version字段时，默认取 registry 中最新稳定版；加了"version>=": "1.1.0"才会触发版本约束 - 首次运行
vcpkg install后会自动生成vcpkg-lock.json，务必提交进 Git
CMakeLists.txt 怎么接入 manifest 依赖
vcpkg manifest 模式下，vcpkg install 会生成一个工具链文件（vcpkg-toolchain.cmake），CMake 必须通过 -DCMAKE_TOOLCHAIN_FILE 显式传入，否则找不到包。
立即学习“C++免费学习笔记（深入）”；
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
推荐做法是在项目根目录运行：
cmake -B build -S . -DCMAKE_TOOLCHAIN_FILE=/path/to/vcpkg/scripts/buildsystems/vcpkg.cmake
注意：/path/to/vcpkg 是你本地 vcpkg 根目录，不是项目里的 vcpkg.json 所在路径。CMakeLists.txt 里无需调用 find_package 前加 vcpkg 相关宏——只要 toolchain 正确，find_package(fmt) 就能直接命中。
- Windows 上若用 Visual Studio 生成器，必须指定
-G "Visual Studio 17 2022" -A x64等平台参数，否则 toolchain 可能漏掉 triplet 信息 - Linux/macOS 默认 triplet 是
x64-linux或x64-osx，但如果你在vcpkg.json里写了"platform": "windows"，就得配 Windows triplet，否则依赖不生效 -
vcpkg install不会自动 rebuild 已安装的包——改了vcpkg.json后，要手动vcpkg remove --outdated再install，否则 lockfile 不更新
常见报错和绕过方法
最典型的是 CMake 报 Could not find fmt using package configuration，本质是 toolchain 没生效或 triplet 不匹配。
- 检查
CMAKE_TOOLCHAIN_FILE路径是否指向vcpkg/scripts/buildsystems/vcpkg.cmake（不是vcpkg.json！） - 运行
vcpkg list看当前 triplet 下是否真装了fmt:x64-windows（或对应平台）；没装就说明vcpkg install没走对 triplet - 错误信息里出现
Failed to load port 'xxx'：多半是vcpkg.json里写的包名拼错，比如写成"fmtlib"（正确是"fmt"），vcpkg registry 不认这个别名 - CI 构建失败且提示
vcpkg-lock.json is out of date：说明有人改了vcpkg.json但没提交新的 lockfile，删掉旧 lockfile，本地vcpkg install重生成再提交
manifest 模式真正难的不是写 JSON，而是理解 toolchain 和 triplet 的耦合关系——一旦 CMake 没走对 toolchain，所有依赖都像没装过一样。锁住 triplet、提交 lockfile、验证 vcpkg list 输出，这三步缺一不可。
