确认 vcpkg 已正确接入 CMake 的关键是 CMake 配置阶段能否找到 vcpkg 工具链，需通过 -DCMAKE_TOOLCHAIN_FILE 显式指定路径或验证 cmake -S . -B build -DCMAKE_TOOLCHAIN_FILE=... 是否成功，且 CMake 版本不低于 3.21。
怎么确认 vcpkg 已正确安装并接入 CMake
关键不是“装了没”，而是 CMake 能不能在配置阶段找到 vcpkg 提供的工具链。常见错误是只运行了 git clone 和 bootstrap-vcpkg.bat/sh，但没把 vcpkg 路径告诉 CMake。
- Windows 下推荐将
vcpkg克隆到无空格、无中文路径，例如C:\src\vcpkg - 执行
.\vcpkg integrate install（需管理员权限），它会把默认 toolchain 文件注册进系统级 CMake 配置 - 验证方式：新建空目录，运行
cmake -S . -B build -DCMAKE_TOOLCHAIN_FILE="C:/src/vcpkg/scripts/buildsystems/vcpkg.cmake"，不报错即接入成功 - 若用 VS 或 CLion，需在项目设置中显式指定
CMAKE_TOOLCHAIN_FILE，IDE 不会自动读取vcpkg integrate的注册结果
vcpkg.json 是什么，为什么不能只靠命令行 install
vcpkg.json 是 Manifest 模式的核心，它不是可选配置文件，而是声明式依赖契约。不用它，vcpkg install 安装的包不会被 CMake 自动发现，且无法保证构建可复现。
- 文件必须放在项目根目录（即
CMAKE_SOURCE_DIR所在目录） - 最小合法内容：
{ "name": "my-project", "version-string": "0.1.0", "dependencies": [ "fmt", "nlohmann-json" ] } - 依赖名必须和 vcpkg registry 中的端口名完全一致（区分大小写），比如
openssl不是OpenSSL - CMakeLists.txt 中必须启用
vcpkg的自动发现逻辑：project(... VERSION ...)后立即加find_package(fmt CONFIG REQUIRED)，否则即使有vcpkg.json也不会触发包解析
为什么 find_package 报错 “Could not find fmtConfig.cmake”
这不是 fmt 没装，而是 CMake 没走到 vcpkg 的包查找路径。Manifest 模式下，vcpkg 不把头文件/库复制到系统路径，而是通过 toolchain 注入临时变量让 CMake 知道去哪找。
- 确保
CMAKE_TOOLCHAIN_FILE指向的是vcpkg/scripts/buildsystems/vcpkg.cmake，不是vcpkg.cmake的旧版或自定义变体 - 检查
vcpkg.json是否在cmake -S指定的源码目录里；如果-S指向子目录（如src/），CMake 就找不到vcpkg.json - 运行
vcpkg list看fmt:x64-windows是否已安装；Manifest 模式默认按当前平台 triplet 构建，未安装时 CMake configure 阶段会静默失败，需手动运行vcpkg install fmt或启用vcpkg install --triplet x64-windows - 避免在 CMakeLists.txt 中写
set(CMAKE_PREFIX_PATH ...)覆盖 vcpkg 注入的路径
如何控制 triplet 和动态/静态链接行为
vcpkg 默认用 x64-windows（Windows）、x64-linux（Linux），但实际项目常需统一 triplet 或强制静态链接。这些不能靠 find_package() 参数控制，必须提前约定。
立即学习“C++免费学习笔记（深入）”；
- 在
vcpkg.json中添加"default-features": false并显式声明"features"，避免隐式依赖带来链接冲突 - 通过环境变量控制全局 triplet：
set VCPKG_DEFAULT_TRIPLET=x64-windows-static（Windows）或export VCPKG_DEFAULT_TRIPLET=x64-linux-dynamic（Linux） - 若用
vcpkg install手动预装，必须带--triplet参数，例如：vcpkg install fmt --triplet x64-windows-static - 静态链接时，确保所有依赖（包括 transitive 依赖）都支持该 triplet；某些端口（如
qt）默认禁用静态构建，需查其CONTROL文件中的supports字段
CMake configure 阶段是否输出 -- Running vcpkg install 行，是 Manifest 模式生效最直接的信号。没看到这行，基本可以确定 vcpkg.json 位置不对、toolchain 未生效，或 CMake 版本低于 3.21（Manifest 模式最低要求）。
