yaml-cpp默认丢弃注释，需用底层YAML::Parser事件流手动提取COMMENT事件并依行号、缩进和顺序推断归属，写回时亦不支持注释注入，无官方API实现注释绑定与保留。yaml-cpp 默认完全丢弃注释，无法读取这是最常被误解的一点：yaml-cpp 的标准解析流程（YAML::Load / YAML::LoadFile）在构建 AST 时会主动剥离所有注释节点。它只保留语义内容，注释不参与数据建模，也不存入 YAML::Node 结构中。这不是 bug，是设计选择 —— 它对标的是“配置消费场景”，而非“配置编辑/重写场景”。所以如果你用常规方式解析后尝试访问某个字段的“注释”，结果必然是空。连影子都没有。必须启用解析器的 Parser 底层接口并手动遍历事件流要拿到注释，得绕过高层 YAML::Load，改用底层事件驱动解析：构造 YAML::Parser，逐个读取 YAML::Event，并在 YAML::Event::COMMENT 类型事件中提取原始字符串。关键点：立即学习“C++免费学习笔记（深入）”；YAML::Parser 不自动跳过注释；它把注释当作独立事件发出注释事件（YAML::Event::COMMENT）的 Mark() 可定位行号，GetScalar() 返回去除了 # 和前导空格的纯文本你得自己维护上下文（比如当前在哪个 key 下），因为事件流里没有嵌套结构信息不能混用 YAML::Parser 和 YAML::Load —— 前者不生成 YAML::Node，后者根本不暴露事件示例片段（仅示意逻辑）：YAML::Parser parser(input_stream);YAML::Event event;while (parser.GetNextEvent(event)) { if (event.type() == YAML::Event::COMMENT) { std::string comment = event.GetScalar(); // 如 "this is a comment" std::size_t line = event.Mark().line; // 行号从 0 开始 }}注释位置决定能否关联到具体字段：行首 vs 行尾 vs 空行YAML 注释本身没有“归属”语义，yaml-cpp 也**不提供注释与键值的自动绑定**。你看到的“某字段上方的注释”，其实是靠人工推断出来的 —— 靠事件顺序、缩进层级、前后 Mark 行号差值来猜。 Vozo Vozo是一款强大的AI视频编辑工具，可以帮助用户轻松重写、配音和编辑视频。