xdocument是c#推荐的xml读取方式,简洁灵活、无需强类型;需显式处理编码和命名空间,避免xmlexception和空引用异常,建议抽离编码与命名空间为常量。

XDocument 是当前 C# 读取 XML 最推荐的方式,比 XmlDocument 更简洁,比 XmlSerializer 更灵活,尤其适合结构不固定、需筛选或投影的场景。它不依赖强类型类定义,也不强制要求无参构造函数,对配置类、日志片段、混合命名空间的 XML 更友好。
用 XDocument.Load() 读取本地文件时路径和编码要显式处理
默认会按系统编码(如 GBK)尝试解析,但多数 XML 文件声明了 <?xml version="1.0" encoding="utf-8"?>。若实际编码与声明不符,XDocument.Load("config.xml") 可能抛出 XmlException:“无法从当前编码转换字符”。
- 稳妥做法是先用
StreamReader指定编码再加载:var stream = new StreamReader("config.xml", Encoding.UTF8);<br>var doc = XDocument.Load(stream); - 避免直接传路径字符串,尤其当路径含中文或空格时;
Path.GetFullPath()可提前标准化 - 若文件可能不存在,别依赖
Load()的异常捕获——先用File.Exists()判断更可控
用 XElement.XPathSelectElements() 替代 SelectNodes() 处理带命名空间的 XML
XmlDocument.SelectNodes() 在遇到 xmlns="http://example.com/ns" 时必须注册 XmlNamespaceManager,否则查不到任何节点;而 XElement 原生支持前缀绑定,写法更直觉。
- 先声明命名空间:
XNamespace ns = "http://example.com/ns";<br>var items = doc.Root.Elements(ns + "item");
- 或用 XPath(需引用
System.Xml.XPath):var manager = new XmlNamespaceManager(new NameTable());<br>manager.AddNamespace("x", "http://example.com/ns");<br>var nodes = doc.XPathSelectElements("//x:item", manager); - 注意:
XElement.XPathSelectElements()不支持默认命名空间(即无前缀的xmlns="..."),此时必须用第一种方式显式拼接
用 Elements().Attributes() 和 Elements().Elements() 避免空引用异常
XML 节点缺失时,node["attr"] 或 node.Element("child") 返回 null,直接调 .Value 会触发 NullReferenceException。LINQ to XML 提供安全链式访问:
- 用
?.和空合并操作符:string title = item.Element("title")?.Value ?? "N/A";<br>string ver = item.Attribute("version")?.Value ?? "1.0"; - 用
Elements()替代Element():前者返回IEnumerable<xelement></xelement>,即使无子节点也返回空集合,可直接FirstOrDefault()或Any() - 批量提取同级属性时,别循环
node.Attributes()后再.Cast<xattribute>()</xattribute>——node.Attributes()本身就是可枚举的
真正容易被忽略的是命名空间和编码这两个隐性依赖:它们不出现在代码主干里,却决定整个解析是否成功。一旦 XML 来自第三方或跨平台生成,这两处几乎必踩坑。建议把编码声明和命名空间 URI 提前抽成常量,而不是硬编码在 Load() 或 XNamespace 初始化里。











