pugixml默认忽略XML注释节点，必须显式启用pugi::xml_parse_comments标志（与pugi::parse_default按位或）才能加载注释；注释节点类型为pugi::node_comment，需用node.value()获取内容，且仅存在于nodes()序列中。
直接说结论：pugixml 默认会忽略 XML 注释节点，pugi::xml_parse_comments 这个解析选项必须显式开启，否则 document.child("root").first_child() 之类遍历根本看不到注释——不是你代码写错了，是它压根没加载进来。
必须启用 pugi::xml_parse_comments 才能读到注释
pugixml 的解析行为高度依赖 flag 组合。默认调用 doc.load_string(...) 或 doc.load_file(...) 时，只启用基础解析（pugi::parse_default），而注释、CDATA、DTD 等都属于“可选内容”，需要手动加 flag：
-
pugi::xml_parse_comments是唯一让注释节点进入 DOM 树的开关 - 它不能单独使用，需与
pugi::parse_default按位或组合，例如：pugi::parse_default | pugi::xml_parse_comments - 如果还希望保留 CDATA 节点，再叠加
pugi::parse_cdata
错误写法：doc.load_string(xml_str); → 注释全丢弃；正确写法：doc.load_string(xml_str, pugi::parse_default | pugi::xml_parse_comments);
注释节点类型是 pugi::node_comment，不是 pugi::node_element
即使启用了注释解析，也不能用常规元素遍历方式直接“拿到注释内容”。注释是独立节点类型，需显式判断：
生成Blender Python (bpy)脚本，该脚本使用node_groups API和GeometryNodeTree接口程序化地创建几何节点修改器树，用于参数化3D资产生成。
立即学习“C++免费学习笔记（深入）”；
- 遍历时用
node.type() == pugi::node_comment判断是否为注释 - 获取注释文本用
node.value()（不是node.text().get()，后者对注释返回空） - 注释节点不会出现在
node.children()中，但会出现在node.nodes()或node.first_node()的完整节点序列里
示例片段：
for (pugi::xml_node node = root.first_node(); node; node = node.next_sibling()) {
if (node.type() == pugi::node_comment) {
std::cout << "Comment: " << node.value() << "\n";
}
}注释位置影响遍历顺序，和元素混排时需小心处理
XML 中注释可以出现在任意位置：根元素外、元素之间、甚至元素开始标签后、结束标签前。pugixml 会严格按源码顺序将注释作为 sibling 节点插入 DOM：
- 若 XML 是
<root><!-- a --><item></item><!-- b --></root>，则root.first_child()返回的是注释节点（"a"），不是item - 想跳过注释只取子元素？得自己过滤：
for (auto child : root.children()) { ... }—— 注意：children()只返回node_element，自动跳过注释；但nodes()不跳 - 修改/删除注释时，要用
node.parent().remove_child(node)，不能直接node.remove()
最常被忽略的一点：pugixml 不提供“注释绑定到某个元素”的语义支持。所谓“某元素的注释”，只是靠位置相邻实现的逻辑关系，DOM 层面它们就是平级 sibling。如果业务需要这种绑定，得自己根据 next_sibling()/previous_sibling() 手动关联，且要小心空格文本节点干扰。
