vcpkg install yaml-cpp 后 cmake 找不到包，因 vcpkg 默认不自动注入查找路径；需运行 vcpkg integrate install 全局集成，或在 cmake 命令中指定 -dcmake_toolchain_file；并确保 find_package(yaml-cpp config required) 和 target_link_libraries(... private yaml-cpp::yaml-cpp) 正确使用。
vcpkg install yaml-cpp 后为什么 CMake 找不到包
因为 vcpkg 默认不自动注入到 CMake 的查找路径，除非你显式启用集成或手动配置。常见现象是 find_package(yaml-cpp) 报错：Could not find yaml-cpp 或 Could not find a package configuration file。
- 运行
vcpkg integrate install（全局集成），它会把 vcpkg 的 toolchain 和模块路径写入用户级 CMake 配置 - 若只用于当前项目，更推荐在 CMake 命令中加
-DCMAKE_TOOLCHAIN_FILE=[vcpkg-root]/scripts/buildsystems/vcpkg.cmake - 别用
vcpkg integrate project：它改的是 Visual Studio 项目文件，对纯 CMake 工程无效，且容易和 CMakeLists.txt 冲突 - 确认安装的是正确三元组，比如
vcpkg install yaml-cpp:x64-windows，而 CMake 构建时也得用-A x64（Windows）或对应 triplet
CMakeLists.txt 中如何正确 find_package yaml-cpp
yaml-cpp 提供的是基于 Config 模式的包（不是 Findyaml-cpp.cmake），所以必须确保 find_package 调用方式匹配其导出的 target 名称——实际是 yaml-cpp（全小写），不是 YAML_CPP 或 yaml_cpp。
- 必须启用
CONFIG模式：find_package(yaml-cpp CONFIG REQUIRED) - 链接时用
target_link_libraries(myapp PRIVATE yaml-cpp::yaml-cpp)，注意双冒号和大小写 - 不要手动
include_directories()：vcpkg 导出的 target 已含头文件路径和编译定义（如YAML_CPP_DLL） - 如果 CMake 版本 find_package(... CONFIG) 可能失败，建议升级或改用
vcpkg install yaml-cpp --triplet ...后检查vcpkg export yaml-cpp --raw输出的 CMake 变量名
链接失败：undefined reference to `YAML::LoadFile` 等符号
这是典型的静态/动态链接不一致问题。vcpkg 默认构建静态库（yaml-cpp 的 vcpkg.json 中未设 "supports": "dynamic"），但你的项目可能隐式依赖 DLL，或没正确定义宏。
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
- 确认构建类型统一：在
vcpkg install时加--dynamic（如vcpkg install yaml-cpp:x64-windows --dynamic），否则默认静态链接需定义YAML_CPP_STATIC_DEFINE - Windows 下若用动态库，必须在编译选项中加
YAML_CPP_DLL（CMake 中用target_compile_definitions(myapp PRIVATE YAML_CPP_DLL)） - 检查
yaml-cpp是否被重复安装多个版本（比如同时装了x64-windows和x64-windows-static），CMake 可能选错 config 文件 - 用
vcpkg list和vcpkg inspect yaml-cpp确认实际安装的 triplet 和库类型
跨平台构建时 yaml-cpp 头文件路径不一致
Linux/macOS 下 vcpkg 安装的头文件路径和 Windows 不同，但只要走 find_package + target link，CMake 就能自动处理——前提是没在代码里硬写 #include <yaml-cpp></yaml-cpp> 这种相对路径。
- 始终用
#include <yaml-cpp></yaml-cpp>（标准头名），不要写成#include "yaml.h"或带绝对路径 - 避免在 CMake 中用
include_directories(${YAML_CPP_INCLUDE_DIRS})：这个变量由旧版 Find 模块提供，vcpkg 的 Config 模式不设它，强行用会导致 Linux 下找不到头文件 - macOS 上若遇到
ld: library not found for -lyaml-cpp，确认是否用了--dynamic并在target_link_libraries中正确引用yaml-cpp::yaml-cpp，而不是裸写yaml-cpp
最常被忽略的一点：vcpkg 的 toolchain 文件必须在 CMake configure 阶段就传入，不能等 generate 阶段再补；一旦缓存生成，改 toolchain 也不生效，得删掉 build/CMakeCache.txt 重来。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
