yaml-cpp 用于 C++：完整指南与示例

\n\n

1. 什么是 yaml-cpp 以及为什么需要它

\n\n

yaml-cpp 是一个轻量级、现代化的 C++ 库，用于解析和生成 YAML 文件。YAML（YAML Ain't Markup Language）是一种人类可读的数据序列化格式，常用于配置文件、数据结构描述、CI/CD 流水线（例如 GitHub Actions、GitLab CI）以及服务间的数据交换。与 JSON 不同，YAML 支持注释、多行字符串、锚点和别名，使其成为配置文件的理想选择。

\n\n

为什么要使用 yaml-cpp？如果您正在编写一个需要读取配置文件（例如服务器设置、机器学习模型参数、依赖项描述）的 C++ 应用程序，yaml-cpp 提供了一个简单且类型安全的 API。该库完全符合 YAML 1.2 规范，支持所有数据类型（标量、序列、映射），并允许轻松地将 YAML 文档转换为 C++ 结构，反之亦然。

\n\n

主要优势：依赖最小（仅需 C++11/14/17 标准库）、可选的头文件-only 构建、支持 Unicode、可为自定义类型进行自定义序列化，以及活跃的社区（GitHub 上超过 5000 颗星）。

\n\n

2. 安装

\n\n

yaml-cpp 不能通过语言包管理器（如 pip、npm）安装。对于 C++，需要使用系统包管理器或从源代码构建。

\n\n

Linux (Debian/Ubuntu)

\n

sudo apt-get install libyaml-cpp-dev

\n\n

macOS (Homebrew)

\n

brew install yaml-cpp

\n\n

Windows (vcpkg)

\n

vcpkg install yaml-cpp

\n\n

从源代码构建 (CMake)

\n

git clone https://github.com/jbeder/yaml-cpp.git\ncd yaml-cpp\nmkdir build && cd build\ncmake -DYAML_BUILD_SHARED_LIBS=ON ..\nmake\nsudo make install

\n\n

安装后，在 CMakeLists.txt 中链接库：

\n

find_package(yaml-cpp REQUIRED)\ntarget_link_libraries(my_project yaml-cpp)

\n\n

3. 快速入门 — 最小工作示例

\n\n

创建文件 config.yaml：

\n

server:\n  host: "localhost"\n  port: 8080\ndebug: true

\n\n

使用 yaml-cpp 读取它：

\n

#include <iostream>\n#include <yaml-cpp/yaml.h>\n\nint main() {\n    // 加载 YAML 文件\n    YAML::Node config = YAML::LoadFile("config.yaml");\n    \n    // 读取值\n    std::string host = config["server"]["host"].as<std::string>();\n    int port = config["server"]["port"].as<int>();\n    bool debug = config["debug"].as<bool>();\n    \n    std::cout << "Host: " << host << "\\n";\n    std::cout << "Port: " << port << "\\n";\n    std::cout << "Debug: " << std::boolalpha << debug << "\\n";\n    \n    return 0;\n}

\n\n

编译：g++ -std=c++17 main.cpp -lyaml-cpp -o app

\n\n

4. 主要方法/函数/类

\n\n

4.1. YAML::Node — 用于操作节点的主要类

\n

签名： class YAML::Node

\n

描述： 表示 YAML 文档中的任何元素：标量、序列（数组）或映射（字典）。支持迭代、按键/索引访问、类型检查。

\n

YAML::Node node;\nnode["name"] = "Alice";\nnode["age"] = 30;\nnode["hobbies"].push_back("reading");\nnode["hobbies"].push_back("coding");\n\nstd::cout << node["name"].as<std::string>() << "\\n"; // Alice\nstd::cout << node["hobbies"][0].as<std::string>() << "\\n"; // reading