SelectSingleNode返回null主因是XPath路径错误或XML含命名空间但未注册。需确认根节点名、大小写及空白文本节点，含命名空间时必须用XmlNamespaceManager注册前缀并在XPath中使用。
XmlDocument.SelectSingleNode 总是返回 null 怎么办
根本原因就两个：XPath 路径写错，或 XML 含命名空间但没注册。比如 SelectSingleNode("/books/book") 在根不是 <books></books> 时必然失败；更常见的是 XML 带 xmlns="http://example.com"，却直接用 //book 查询。
实操建议：
- 先用
doc.DocumentElement.OuterXml打印实际加载结构，确认根名、大小写、是否有多余的#text节点（换行缩进生成的） - 含命名空间时，必须创建
XmlNamespaceManager，注册前缀，再在 XPath 中使用，例如：var nsmgr = new XmlNamespaceManager(doc.NameTable);<br>nsmgr.AddNamespace("ns", "http://example.com");<br>doc.SelectSingleNode("/ns:root/ns:item", nsmgr); - 优先写绝对路径（如
/root/item/name），少用//name—— 后者会遍历全文，性能差且易匹配到意外节点 -
GetElementsByTagName("book")不支持 XPath，只按标签名查，且返回的是实时集合（后续 DOM 变化会影响它），别和SelectSingleNode混用
修改 XmlNode.InnerText 后保存不生效
常见现象是调用 doc.Save() 后文件内容没变，或者抛 UnauthorizedAccessException。这不是 API 问题，而是流控制或权限卡住了。
实操建议：
- 别用
File.OpenWrite()手动传流给Save()——XDocument.Save(string)和XmlDocument.Save(string)都会自己打开/关闭文件，手动传流反而容易漏Dispose - 确保目标路径可写：Windows 上避开
C:\Program Files\，检查文件是否被记事本、VS 或其他进程独占锁定 - 改值用
node.InnerText = "new"，别用node.ReplaceAll("new")—— 后者会清空所有子节点，把嵌套结构（如<name><first>A</first><last>B</last></name>）整个干掉 - 若需保留
<?xml version="1.0" encoding="utf-8"?>，得用带XmlWriterSettings的重载，否则默认可能输出 utf-16
XmlSerializer 反序列化后字段全为 null 或类型转换失败
典型错误信息是 InvalidOperationException：“无法将字符串 '123' 转换为 int”，或某个字段始终是 null。这几乎一定是类定义和 XML 结构对不上，而不是数据本身有问题。
实操建议：
- 属性必须有 public get/set，不能是只读自动属性：
public string Name { get; }会导致反序列化失败 - 用
[XmlElement("ProductName")]显式指定元素名，别依赖默认映射（大小写、下划线规则都可能不一致） - XML 中有属性（如
<item id="123"></item>），对应字段得加[XmlAttribute("id")] - 集合字段必须用
[XmlArray("Items")][XmlArrayItem("Item")]组合，单独[XmlElement]会让层级变成<items><item>...</item><item>...</item></items>，而非预期的<items><item>...</item></items> - 反序列化前用在线校验器或
XmlReader.Create()+Read()粗略过一遍 XML，一个未闭合标签或多余空格就能让整个解析中断
该用 XmlDocument 还是 XDocument
不是哪个“更好”，而是哪个更适合当前场景。老项目维护用 XmlDocument 没问题；新项目无脑选 XDocument；超大文件（>100MB）就得切到 XmlReader。
实操建议：
-
XDocument支持 LINQ 查询，代码更短、更易读，例如：doc.Descendants("Book").Where(b => b.Attribute("Id")?.Value == "1")，比等价的XmlDocumentXPath 表达式直观得多 -
XmlDocument是 .NET Framework 时代主力，DOM 模型完整，但 API 笨重，比如创建带命名空间的元素要写三参数CreateElement，而XElement直接传XNamespace实例 - 性能敏感场景（如日志解析、ETL 流水线），
XmlReader内存占用恒定，但只能单向读，不能回溯或修改 —— 它不是用来“操作” XML 的，是用来“路过并提取”的 - 别在同一个项目里混用两种模型来回转换，
XDocument.ToXmlDocument()和XmlDocument.ToXDocument()都有隐式开销，且可能丢弃某些元信息（如注释、处理指令）
最常被忽略的一点：命名空间不是“可选附加项”，而是 XML 的一级公民。一旦文档声明了 xmlns，所有未显式声明前缀的元素都属于那个命名空间 —— 这个事实决定了 80% 的 SelectSingleNode 失败案例，但它在调试时完全不报错，只静默返回 null。
