C++如何解析带命名空间的XML文件

libxml2需用xmlSearchNs获取xmlNs*再传给xmlGetNsProp；tinyxml2需手动剥离前缀；rapidxml完全无视命名空间；pugixml须显式注册XPath命名空间映射。

用 libxml2 解析带命名空间的 XML 时，xmlGetNs 和 xmlSearchNs 必须配对使用

libxml2 默认不自动绑定命名空间前缀到节点，直接用 xmlGetProp 或 xmlGetNsProp 查属性会失败——即使属性带前缀（如 xsi:type），也不认。关键不是“怎么读”，而是“怎么让解析器知道前缀对应哪个 URI”。

常见错误现象：调用 xmlGetNsProp(node, BAD_CAST "type", BAD_CAST "xsi") 返回 nullptr，但手动检查 XML 确实有 xsi:type="string"。

• 必须先用 xmlSearchNs(doc, node, BAD_CAST "xsi") 获取 xmlNs* 指针，不能硬编码或复用其他节点的 namespace 指针
• xmlGetNsProp 第三个参数必须是该 xmlNs*，不是前缀字符串；传错会导致段错误或静默失败
• 命名空间声明可能在父节点（甚至根节点），所以 xmlSearchNs 的第二个参数（起始节点）要选对，通常传当前节点即可，libxml2 会向上查找

tinyxml2 中处理命名空间需手动剥离前缀，Element::QueryValueText 不支持带冒号的标签名

tinyxml2 完全不提供命名空间解析能力，它把 <ns:tag> 当作普通标签名处理。这意味着 doc.FirstChildElement("ns:tag") 会返回 nullptr，因为实际 Element::Value() 是 "ns:tag"，不是 "tag"。

使用场景：你只关心元素内容、不验证 schema，且能控制 XML 格式（比如自己生成的带固定前缀的配置文件）。

立即学习“C++免费学习笔记（深入）”；

• 用 element->Value() 取出完整标签名，再用 strchr 或 std::string::find(':') 找冒号位置，截取本地名部分
• 属性同理：element->Attribute("xsi:type") 会失败，得遍历所有属性，用 attribute->Name() 判断是否以 "xsi:" 开头
• 性能影响小，但代码变啰嗦；如果 XML 来自不可信来源或前缀不固定，容易漏匹配（比如前缀是 xs: 或 schema:）

rapidxml 对命名空间完全无感知，rapidxml::xml_node::first_node("ns:tag") 会找不到节点

rapidxml 是纯 header-only、零分配的解析器，设计目标就是快和轻量，因此主动放弃命名空间支持。它把所有带冒号的名称（ns:tag、xsi:nil）原样存为节点名或属性名，不做任何解析或映射。

容易踩的坑：以为加了 xmlns:ns="http://example.com" 声明后，就能用前缀查节点——实际上 rapidxml 根本不解析这些声明，xmlns: 属性只是普通属性而已。

• 唯一可靠方式：忽略前缀，用 node->first_node() 遍历子节点，再用 strcmp(node->name(), "tag") == 0 匹配本地名（注意：node->name() 返回的是完整字符串，含前缀）
• 若需区分同名不同 ns 的元素（如 foo:bar 和 baz:bar），必须结合父节点的 xmlns: 属性手动提取 URI，无法靠库自动完成
• 兼容性好、编译快，但一旦 XML 命名空间逻辑复杂（如嵌套不同 ns、默认 ns 切换），就得自己实现 namespace scope stack

用 pugixml 时，pugi::xml_node::child 不支持带前缀查找，得用 select_node + XPath

pugixml 支持命名空间，但接口设计偏向显式控制：它不会自动将前缀绑定到查询上下文，XPath 查询必须显式注册命名空间映射，否则 //ns:tag 直接报错或返回空。

典型错误：调用 node.child("ns:tag") 返回空，而 node.child("tag") 也为空——因为 pugixml 默认不拆分前缀，child() 只匹配完整节点名。

• 正确做法是用 XPath：pugi::xpath_query query(".//ns:tag", &ns);，其中 ns 是 pugi::xpath_variable_set，需提前用 ns.add("ns", "http://example.com"); 注册
• 注册的 prefix（第一个参数）必须和 XPath 表达式里的一致，URI（第二个参数）必须和 XML 中 xmlns:ns="..." 的值严格相等（包括末尾斜杠）
• 如果 XML 有默认命名空间（xmlns="http://default.com"），XPath 中要用 default:tag 并注册 ns.add("default", "...")，不能省略前缀

命名空间不是“开关”，而是每个查询上下文里的显式字典；漏注册、拼错 URI、前缀不一致，都会让 XPath 失效，而且没有运行时提示。