应使用XNamespace.GetDefaultNamespace()或GetNamespaceOfPrefix()从XML文档中获取命名空间，而非硬编码字符串；查询、创建元素及属性时均需显式拼接XNamespace，确保全程字符串严格一致。
用 XNamespace.Get() 获取命名空间时，别直接拼字符串
很多人写 XNamespace ns = "http://example.com/ns" 看似没问题，但一旦 XML 里声明的是 xmlns:ns="http://example.com/ns" 或带尾部斜杠（http://example.com/ns/），就查不到元素。Linq to XML 对命名空间字符串是严格全等匹配的，多一个空格、少一个斜杠都不行。
正确做法是先从文档中读出来：
var doc = XDocument.Load("data.xml");
XNamespace ns = doc.Root?.GetDefaultNamespace() ?? XNamespace.None;
// 或按前缀取：XNamespace ns = doc.Root?.GetNamespaceOfPrefix("ns") ?? XNamespace.None;
- 永远优先用
GetDefaultNamespace()或GetNamespaceOfPrefix()，而不是硬编码字符串 - 如果根节点没声明命名空间，返回的是
XNamespace.None，这时用ns + "ElementName"实际生成的是{null}ElementName，能正常匹配无命名空间的元素 - 注意：
XNamespace.None不等于null，不能判空，要用== XNamespace.None
查询带命名空间的元素时，必须显式拼接 XNamespace
doc.Descendants("Item") 在带命名空间的 XML 中永远返回空——它只找无命名空间的 Item。Linq to XML 不会自动“忽略”或“推断”命名空间。
必须把命名空间和本地名组合起来：
XNamespace ns = doc.Root.GetDefaultNamespace(); var items = doc.Descendants(ns + "Item");
- 不能写
doc.Descendants("{http://example.com/ns}Item")：虽然语法合法，但易出错且不可维护 - 如果 XML 用前缀（如
xmlns:api="http://api.example.com"），就用doc.Root.GetNamespaceOfPrefix("api") + "User" - 属性访问也一样：要查
api:Id，得写el.Attribute(ns + "Id")，不是el.Attribute("Id")
创建新元素时，XNamespace 必须参与构造
用 new XElement("User", ...) 创建的元素默认无命名空间，即使你当前上下文有命名空间，也不会自动继承。结果就是：生成的 XML 里元素“裸奔”，跟原始结构不一致，下游系统可能拒收。
新建元素必须带上命名空间：
XNamespace ns = XNamespace.Get("http://example.com/ns");
var user = new XElement(ns + "User",
new XElement(ns + "Name", "Alice"),
new XAttribute(ns + "Id", "123")
);
- 别漏掉属性的命名空间——
XAttribute同样需要ns + "AttrName" - 如果想让子元素继承父命名空间，仍需显式指定；Linq to XML 没有“作用域继承”机制
- 用
XElement.Add()追加已有带命名空间的元素时，不用重复加命名空间，但新创建的必须加
解析失败却没报错？很可能是命名空间不匹配导致空集合
最常见的静默失败：代码跑起来不抛异常，但 .Elements()、.Descendants()、.Attribute() 全返回空，列表长度为 0。这不是 bug，是设计使然——匹配不到就返回空序列，不是 throw。
调试时优先确认三件事：
- 用
doc.Root?.Name.Namespace打印实际命名空间 URI，别信 DTD 或文档说明 - 检查 XML 是否用了默认命名空间（
xmlns="..."）还是带前缀的（xmlns:ns="..."），二者获取方式不同 - 用
doc.Root?.Nodes().OfType<xelement>().Select(x => x.Name)</xelement>快速看真实元素名（含命名空间前缀）
命名空间处理本身不复杂，但所有环节都要求“显式一致”：读、查、建、改，每一步的命名空间对象必须是同一个实例，字符串哪怕差一个字符，就彻底断连。
