📌 项目地址：jbeder/yaml-cpp | ⭐ 6,064 颗星 | 🔧 C++ | 📜 未标注
核心价值：为 C++ 项目提供 YAML 的完整读写能力
YAML 因其可读性高、支持复杂数据结构而成为配置文件和序列化的常用格式。但 C++ 标准库并不包含 YAML 处理能力，开发者需要引入第三方库。yaml-cpp 是目前 C++ 生态中最成熟、社区最认可的 YAML 解析与生成库，它严格遵循 YAML 1.2 规范，同时提供了 C++ 风格的接口，让开发者能像操作 STL 容器一样读写 YAML 节点。
项目起于 2009 年，至今累计 6064 颗 Star，长期维护，2024 年仍在发布新版本（最新稳定版 0.9.0）。对于需要将 YAML 作为配置语言（如游戏引擎、服务端框架、CI/CD 工具）的 C++ 项目，yaml-cpp 是首选方案。
实际用法：从构建到集成
1. 使用 CMake 构建
官方推荐通过 CMake 构建。基本步骤（来自 README）：
mkdir build
cd build
cmake [-G generator] [-DYAML_BUILD_SHARED_LIBS=on|OFF] ..
- 若不指定 generator，CMake 会使用系统默认生成器（UNIX-like 下为 Makefile）。
- 默认生成静态库，若要动态库则添加
-DYAML_BUILD_SHARED_LIBS=ON。 - 如果需要调试模式，可同时设置
-D CMAKE_CXX_FLAGS_DEBUG='-g -D_GLIBCXX_DEBUG'。
构建完成后（例如 make 或打开 Visual Studio 工程），即可使用生成的库文件。
2. 在 CMake 项目中集成（推荐）
使用 CMake 的 FetchContent 模块，无需手动下载源码。直接在你的 CMakeLists.txt 中添加：
include(FetchContent)
FetchContent_Declare(
yaml-cpp
GIT_REPOSITORY https://github.com/jbeder/yaml-cpp.git
GIT_TAG yaml-cpp-0.9.0 # 可指定 tag、commit hash 或分支名
)
FetchContent_MakeAvailable(yaml-cpp)
target_link_libraries(YOUR_LIBRARY PUBLIC yaml-cpp::yaml-cpp)
之后在 C++ 代码中 #include "yaml-cpp/yaml.h" 即可使用接口。
3. 具体解析与生成用法
README 未提供代码示例，但官方 Wiki 包含两份详细教程：
– Tutorial（解析）：演示如何加载 YAML 字符串/文件、遍历节点、获取标量值（node["key"].as<int>()）等。
– How to Emit YAML（生成）：演示如何构建 YAML 节点、输出为字符串或文件。
实际使用中，yaml-cpp 的核心是 YAML::Node 类，支持下标访问、迭代器、类型转换。例如：
YAML::Node config = YAML::LoadFile("config.yaml");
std::string name = config["name"].as<std::string>();
int version = config["version"].as<int>();
生成则通过 YAML::Emitter 或直接构建 Node 后调用 YAML::Dump()。
同类工具对比：yaml-cpp 的独特定位
C++ 领域处理 YAML 的库不多，主要有：
- libyaml（C语言）：最底层的 YAML 解析器，性能极高，但需要手动管理内存和事件回调，开发效率低。
- rapidyaml：较新的 C++ 库，注重性能，支持就地解析，但接口相对较底层，文档不如 yaml-cpp 完善。
- yaml-cpp：开箱即用的 C++ 风格接口，Node 模型与 JSON 类似，符合开发者直觉；完全支持 YAML 1.2（而许多早期库只支持 1.0/1.1）；社区成熟，Stack Overflow 有大量相关问题；CMake 集成简单（FetchContent / find_package）。
对于大多数不追求极致性能、希望快速集成 YAML 处理能力的项目，yaml-cpp 是最省心的选择。
需要注意的事项
- 许可证：yaml-cpp 使用 MIT 许可证，允许商业闭源使用，无额外限制。
- 维护节奏：项目并非频繁发布新版本（0.9.0 距离上一个版本 0.7.0 间隔数年），但 issue 仍有人响应。如果需要最新修复，可以跟踪 master 分支。
- 调试模式兼容性：如果在 Linux 下开启
_GLIBCXX_DEBUG，必须确保 yaml-cpp 和所有依赖（如 Google Test）也用相同标志编译，否则可能出现链接或运行时错误（详见 README）。 - 性能：对于极大文件（数百 MB），yaml-cpp 的 Node 模型会一次性将文档加载到内存，可能带来内存压力。此时可考虑逐事件处理的 libyaml 或 rapidyaml。
- 与旧版本兼容：0.5.0 之前的 API 有较大差异，新版已完全重构。旧项目若使用老 API，需要参考 How To Parse A Document (Old API) 迁移。