0

0

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

裘德小鎮的故事

裘德小鎮的故事

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

|

973人浏览过

|

来源于php中文网

原创

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

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

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

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

常见原因是未捕获 YAML::ParserExceptionYAML::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 构建已支持),且加载时不能跳过解析阶段。

SophNet
SophNet

专业的AI开发工具平台,让AI集成变得简单高效。

下载

立即学习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::LoadYAML::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,需用 iconvMultiByteToWideChar 转换后再构造 std::string
  • 不支持直接写注释;如需注释,只能手拼字符串或改用其他库(如 ryml

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

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
string转int
string转int

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

770

2023.08.02

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

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

547

2023.09.20

string转int
string转int

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

770

2023.08.02

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

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

573

2024.08.29

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

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

254

2025.08.29

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

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

210

2025.08.29

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

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

311

2025.07.15

discuz database error怎么解决
discuz database error怎么解决

discuz database error的解决办法有:1、检查数据库配置;2、确保数据库服务器正在运行;3、检查数据库表状态;4、备份数据;5、清理缓存;6、重新安装Discuz;7、检查服务器资源;8、联系Discuz官方支持。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

217

2023.11.20

pixiv网页版官网登录与阅读指南_pixiv官网直达入口与在线访问方法
pixiv网页版官网登录与阅读指南_pixiv官网直达入口与在线访问方法

本专题系统整理pixiv网页版官网入口及登录访问方式,涵盖官网登录页面直达路径、在线阅读入口及快速进入方法说明,帮助用户高效找到pixiv官方网站,实现便捷、安全的网页端浏览与账号登录体验。

561

2026.02.13

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
C# 教程
C# 教程

共94课时 | 9.7万人学习

C 教程
C 教程

共75课时 | 4.8万人学习

C++教程
C++教程

共115课时 | 18.4万人学习

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

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号