讲师中心 微信公众号
AI工具推荐 视频效率加速

C++如何解析复杂的YAML配置文件_C++使用yaml-cpp库读写教程【实例】

千敏小哥_5334

千敏小哥_5334

发布时间:2026-02-19 07:23:08

|

1033人浏览过

|

来源于php中文网

原创

yaml-cpp解析YAML需手动启用异常处理并检查节点存在性;未捕获YAML::ParserException或YAML::BadConversion、使用Tab缩进、未验证节点定义均会导致程序abort。

c++如何解析复杂的yaml配置文件_c++使用yaml-cpp库读写教程【实例】

yaml-cpp 能解析嵌套、锚点、合并、多文档等 YAML 特性,但默认不启用全部功能;必须手动调用 YAML::LoadFile 或 YAML::Load 并处理异常,否则遇到注释、缩进错误或类型冲突会直接崩溃。

加载 YAML 文件时为什么程序直接 abort?

常见原因是未捕获 YAML::ParserException 或 YAML::BadConversion。yaml-cpp 在解析失败时抛出异常而非返回错误码,且不区分语法错误和类型转换失败。

  • 始终用 try/catch 包裹 YAML::LoadFile("config.yaml")
  • 不要假设 node["port"] 一定存在——先用 node["port"].IsDefined() 检查
  • 若 YAML 含 Tab 缩进,yaml-cpp 会抛 YAML::ParserException(YAML 规范禁止 Tab 作缩进)
  • 使用 CMake 时确保链接 yaml-cpp:在 target_link_libraries 中加入 yaml-cpp

如何安全读取嵌套结构和可选字段?

yaml-cpp 的 operator[] 返回 YAML::Node,它像智能指针一样支持链式访问,但任意一级缺失都会导致后续 as<t>()</t> 抛 YAML::BadConversion。

  • 推荐写辅助函数:int get_as(const YAML::Node& node, const std::string& key, int default_val = 0),内部先 IsDefined() 再 as<int>()</int>
  • 读取数组用 node["servers"].size() + node["servers"][i]["host"].as<:string>()</:string>,注意 i 必须检查
  • 读取映射内嵌套映射:用 node["database"]["credentials"]["user"].as<:string>()</:string> 前,逐级确认 IsDefined() 或用上述辅助函数封装

锚点(&)、别名(*)和

可以,但需确保 yaml-cpp 编译时启用了 YAML_CPP_DISABLE_REGEX 以外的完整解析器(默认 CMake 构建已支持),且加载时不能跳过解析阶段。

C++14
C++14

C++14 对 C++11 的修正与增强版本,适合旧系统维护和较老工具链兼容。

下载

立即学习“C++免费学习笔记(深入)”;

  • 锚点与别名自动解析:写 base: &base { host: localhost, port: 8080 } 和 dev: *base,加载后 root["dev"]["port"].as<int>()</int> 返回 8080
  • 合并需 YAML 1.1+ 语法(yaml-cpp 默认按 1.2 解析),例如:<code>common: &common { timeout: 5 } + api: → <code>root["api"]["timeout"].as<int>()</int> 有效
  • 若发现锚点失效,检查是否误用 YAML::LoadNode(仅解析不构建引用图),应统一用 YAML::Load 或 YAML::LoadFile

写入 YAML 时如何控制格式和避免中文乱码?

yaml-cpp 默认输出无注释、无换行、键无引号,且不处理 UTF-8 BOM;中文字符串若源文件非 UTF-8 编码或终端不支持 UTF-8,会显示为乱码。

  • 设置缩进和行宽:YAML::Emitter emitter; 后调用 emitter.SetIndent(2); emitter.SetWidth(100);
  • 强制字符串加引号(防关键字/空格/中文解析歧义):emitter
  • 写入前确保 std::string 是 UTF-8 编码;Windows 下若源文件为 GBK,需用 iconv 或 MultiByteToWideChar 转换后再构造 std::string
  • 不支持直接写注释;如需注释,只能手拼字符串或改用其他库(如 ryml)

最易被忽略的是:yaml-cpp 不验证 schema,也不提供路径式查询(如 JSON Pointer)。嵌套深、字段多时,靠手写 IsDefined() + 类型断言极易漏检——建议把配置结构封装成类,用构造函数集中做合法性校验,而不是散落在业务逻辑里反复判断。

热门AI工具

更多
花生AI
花生AI Hot

一款AI视频创作工具,主要用于B站推出的AI视频创作工具,适合需要提升相关任务效率的用户。

墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

小橡皮AI

一款AI工具,主要用于小橡皮一键去AI味,将机器味重的内容改得更有活人感,防止因为 AI 内容被平台打上 AI 标签,以及限流,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

Flowith
Flowith Hot

Flowith是一款基于画布和智能体工作流的 AI 协作工作空间。

相关专题

更多
string转int
string转int

在编程中,我们经常会遇到需要将字符串(str)转换为整数(int)的情况。这可能是因为我们需要对字符串进行数值计算,或者需要将用户输入的字符串转换为整数进行处理。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

7219

2023.08.02

c语言const用法
c语言const用法

const是关键字,可以用于声明常量、函数参数中的const修饰符、const修饰函数返回值、const修饰指针。详细介绍:1、声明常量,const关键字可用于声明常量,常量的值在程序运行期间不可修改,常量可以是基本数据类型,如整数、浮点数、字符等,也可是自定义的数据类型;2、函数参数中的const修饰符,const关键字可用于函数的参数中,表示该参数在函数内部不可修改等等。

2398

2023.09.20

string转int
string转int

在编程中,我们经常会遇到需要将字符串(str)转换为整数(int)的情况。这可能是因为我们需要对字符串进行数值计算,或者需要将用户输入的字符串转换为整数进行处理。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

7219

2023.08.02

int占多少字节
int占多少字节

int占4个字节,意味着一个int变量可以存储范围在-2,147,483,648到2,147,483,647之间的整数值,在某些情况下也可能是2个字节或8个字节,int是一种常用的数据类型,用于表示整数,需要根据具体情况选择合适的数据类型,以确保程序的正确性和性能。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

3445

2024.08.29

c++怎么把double转成int
c++怎么把double转成int

本专题整合了 c++ double相关教程,阅读专题下面的文章了解更多详细内容。

4528

2025.08.29

C++中int的含义
C++中int的含义

本专题整合了C++中int相关内容,阅读专题下面的文章了解更多详细内容。

3045

2025.08.29

C++ 智能指针与现代内存管理
C++ 智能指针与现代内存管理

深入讲解 C++ 现代内存管理的核心工具——智能指针,涵盖 unique_ptr 独占所有权语义、shared_ptr 引用计数机制与循环引用问题、weak_ptr 弱引用的应用场景、make_unique/make_shared 工厂函数的性能优势、自定义删除器的编写、RAII 资源管理思想的实践,以及从裸指针迁移到智能指针的重构策略,帮助开发者编写安全无泄漏的现代 C++ 代码。

379

2026.04.23

C++类型转换方式
C++类型转换方式

本专题整合了C++类型转换相关内容,想了解更多相关内容,请阅读专题下面的文章。

2582

2025.07.15

Postman身份认证怎么配置
Postman身份认证怎么配置

本专题从实际API接口调试场景出发,讲解Postman身份认证的完整配置流程,包括常见认证协议介绍、授权参数设置、访问令牌填写、OAuth 2.0授权及认证失败排查,帮助用户正确完成接口授权与访问验证。

0

2026.11.06

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
C++ Core Guidelines
C++ Core Guidelines

共0课时 | 0人学习

C++ Reference
C++ Reference

共0课时 | 0人学习

C++ 官方标准说明
C++ 官方标准说明

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn