XmlNamespaceManager必须手动注册命名空间前缀，否则XPath无法匹配默认命名空间下的节点；需用AddNamespace绑定前缀与URI，且XPath路径中每个元素都须带对应前缀。
XmlNamespaceManager 不是自动加载的，必须手动添加命名空间前缀
很多人以为只要 XML 里写了 xmlns="http://example.com/ns"，XmlDocument 或 XPathNavigator 就能自动识别并匹配元素——其实不会。不显式注册，所有带默认命名空间的节点在 XPath 查询中都“看不见”。
实操要点：
-
XmlNamespaceManager必须和XmlNameTable绑定（通常用doc.NameTable） - 前缀名可以任意取（比如
"x"），但必须和 XPath 中写的前缀一致 - 默认命名空间（无前缀的
xmlns="..."）也必须用前缀映射，不能留空或传""
示例：对 <root xmlns="http://a.b/c"><item>1</item></root>
var nsmgr = new XmlNamespaceManager(doc.NameTable);
nsmgr.AddNamespace("x", "http://a.b/c"); // 关键：给默认 ns 赋予前缀 x
var node = doc.SelectSingleNode("/x:root/x:item", nsmgr); // 必须用 x:root用 SelectSingleNode 时路径写错是常见报错根源
错误现象：SelectSingleNode 返回 null，但 XML 明明有那个节点；或者抛出 XPathException 提示“前缀未声明”。这两种情况基本都卡在命名空间处理上。
关键判断点：
- 检查 XML 是否含
xmlns（尤其是根节点），哪怕只有一处，整个子树都受其影响 - XPath 字符串里每个元素名前都要加前缀（如
/x:root/x:item），不能只写/root/item - 如果用了多个命名空间（比如
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"），每个都要AddNamespace
注意：GetElementsByTagName 这类方法绕过 XPath，不依赖 XmlNamespaceManager，但它返回的是所有同名节点（忽略命名空间），容易误匹配。
用 LINQ to XML 时命名空间处理更直观，但别漏掉 XNamespace.Get
相比老式 XmlDocument，XDocument 的命名空间操作更符合直觉，但新手常漏掉一步：必须用 XNamespace.Get("uri") 构造命名空间对象，再和本地名拼接。
典型错误写法：
var doc = XDocument.Load("file.xml");
var item = doc.Root.Element("item"); // ❌ 默认命名空间下，"item" 找不到正确写法：
var ns = XNamespace.Get("http://a.b/c");
var item = doc.Root.Element(ns + "item"); // ✅ 必须显式拼接其他要点：
-
ns + "item"生成的是XName，不是字符串，不能用ToString()拼 - 如果 XML 有多个命名空间前缀（如
xmlns:ns2="..."），对应用不同XNamespace实例 -
Descendants(ns + "item")比Elements()更常用，因为不依赖层级深度
解析失败时先验证命名空间 URI 是否完全一致
最隐蔽的坑：XML 中写的命名空间 URI 多了一个斜杠、少了一个字母，或大小写不一致（比如 http://example.com/NS vs http://example.com/ns），都会导致匹配失败——而 XML 解析器通常不报错，只是查不到节点。
排查建议：
- 用
doc.DocumentElement.NamespaceURI或doc.Root.Name.Namespace.NamespaceName实际读出 URI，和代码里写的逐字符比对 - 不要从浏览器或编辑器“复制”命名空间 URI，有些会把
- 如果服务端返回的 XML 命名空间动态变化（比如带版本号），硬编码 URI 就不可靠，得先提取再使用
命名空间不是语法糖，它是 XML 的“作用域”，URI 相等才视为同一命名空间——这点和 C# 的 using 别名完全不同。
