在C++项目中处理配置信息时，YAML格式因为结构清晰、可读性强被广泛使用，yaml-cpp是C++生态中成熟的YAML解析库，支持YAML 1.2规范，能够完成各类YAML文件的解析和生成操作。
yaml-cpp环境准备
首先需要完成yaml-cpp库的编译安装，以Linux系统为例，操作步骤如下：
- 从官方仓库获取源码，解压后进入目录
- 创建构建目录执行cmake配置，生成Makefile
- 执行编译和安装命令，将库文件和头文件安装到系统路径
安装完成后，编译自己的C++程序时需要链接yaml-cpp库，编译命令示例：
// 编译时需要添加链接参数，假设源码文件为main.cpp
// g++ main.cpp -o main -lyaml-cpp
#include <iostream>
#include <yaml-cpp/yaml.h>
int main() {
// 测试头文件是否正常引入
std::cout << "yaml-cpp header check success" << std::endl;
return 0;
}
基础YAML文件读取与解析
首先准备一个简单的YAML测试文件，命名为config.yaml，内容如下：
# 基础配置项 app_name: test_app version: 1.0.0 max_connection: 100 enable_log: true # 数组配置 server_list: - 192.168.0.1 - 192.168.0.2 - 127.0.0.1 # 嵌套结构 database: host: 127.0.0.1 port: 3306 username: admin password: 123456
读取YAML文件并提取基础数据
使用yaml-cpp解析上述文件的基础代码如下：
#include <iostream>
#include <yaml-cpp/yaml.h>
#include <vector>
#include <string>
int main() {
try {
// 加载YAML文件，参数为文件路径
YAML::Node config = YAML::LoadFile("config.yaml");
// 提取字符串类型数据
std::string app_name = config["app_name"].as<std::string>();
std::cout << "app_name: " << app_name << std::endl;
// 提取浮点型数据
float version = config["version"].as<float>();
std::cout << "version: " << version << std::endl;
// 提取整型数据
int max_connection = config["max_connection"].as<int>();
std::cout << "max_connection: " << max_connection << std::endl;
// 提取布尔类型数据
bool enable_log = config["enable_log"].as<bool>();
std::cout << "enable_log: " << enable_log << std::endl;
} catch (const YAML::Exception& e) {
// 捕获解析异常，比如文件不存在、格式错误等情况
std::cerr << "YAML解析错误: " << e.what() << std::endl;
return 1;
}
return 0;
}
解析数组类型数据
YAML中的数组对应yaml-cpp的YAML::Node序列类型，可以通过遍历或者下标访问：
#include <iostream>
#include <yaml-cpp/yaml.h>
#include <vector>
#include <string>
int main() {
try {
YAML::Node config = YAML::LoadFile("config.yaml");
YAML::Node server_list = config["server_list"];
// 判断是否为数组类型
if (server_list.IsSequence()) {
std::cout << "server_list数量: " << server_list.size() << std::endl;
// 遍历数组
for (size_t i = 0; i < server_list.size(); ++i) {
std::string server = server_list[i].as<std::string>();
std::cout << "第" << i+1 << "个服务器: " << server << std::endl;
}
}
} catch (const YAML::Exception& e) {
std::cerr << "YAML解析错误: " << e.what() << std::endl;
return 1;
}
return 0;
}
解析嵌套结构数据
YAML中的嵌套结构对应YAML::Node的映射类型，可以通过链式访问提取内层数据：
#include <iostream>
#include <yaml-cpp/yAML.h>
#include <string>
int main() {
try {
YAML::Node config = YAML::LoadFile("config.yaml");
YAML::Node database = config["database"];
// 提取嵌套结构内的数据
std::string host = database["host"].as<std::string>();
int port = database["port"].as<int>();
std::string username = database["username"].as<std::string>();
std::string password = database["password"].as<std::string>();
std::cout << "数据库配置:" << std::endl;
std::cout << "host: " << host << std::endl;
std::cout << "port: " << port << std::endl;
std::cout << "username: " << username << std::endl;
std::cout << "password: " << password << std::endl;
} catch (const YAML::Exception& e) {
std::cerr << "YAML解析错误: " << e.what() << std::endl;
return 1;
}
return 0;
}
常见问题与注意事项
- 解析前需要判断
YAML::Node是否为空，避免访问不存在的键导致异常，可以使用node.IsNull()判断 - 如果YAML文件中某个键可能不存在，可以使用
node["key"] && !node["key"].IsNull()做前置判断 - 数据类型转换时需要保证YAML中的值和目标类型匹配，比如把字符串转为int会抛出异常
- 如果YAML文件中有重复键，yaml-cpp会默认使用后出现的键值对覆盖前面的内容
总结
yaml-cpp库的使用流程主要分为环境配置、加载文件、提取数据三个步骤，核心是通过YAML::Node类操作YAML的各类结构，结合as<T>()方法完成类型转换。实际开发中可以根据配置的结构封装对应的解析函数，提高代码的复用性。如果遇到复杂的YAML结构，也可以先通过YAML::NodeType判断节点类型，再针对性做解析处理。