必须用xdocument.load()。因parse仅处理字符串，会丢失编码声明、doctype、注释等元信息，且易致根重复、命名空间错乱；load可保真结构，配合loadoptions可保留空白与注释。
合并XML文件时，XDocument.Load() 和 XDocument.Parse() 选哪个？
必须用 XDocument.Load()。如果用 XDocument.Parse()，说明你手头是字符串——那已经不是“合并文件”，而是拼接字符串后解析，容易丢失编码声明、DOCTYPE 或注释。直接加载才能保真结构和元信息。
常见错误：把两个文件读成字符串再拼，结果根元素重复、命名空间错乱、<?xml version="1.0"?> 出现两次，解析直接抛 XmlException。
- 用
XDocument.Load("a.xml")和XDocument.Load("b.xml")分别加载 - 确保两文件都有且仅有一个根元素（LINQ to XML 不支持多根文档）
- 若需保留注释或处理指令，加载时传
LoadOptions.PreserveWhitespace | LoadOptions.PreserveSignificantWhitespace
如何安全合并子节点而不破坏命名空间？
直接 a.Root.Add(b.Root.Nodes()) 看似简单，但会把 b 的命名空间前缀（如 xmlns:ns="http://example.com"）变成普通属性，导致后续查询失败。正确做法是先导入节点到目标文档上下文。
核心操作是 XNode.CreateReader() + XContainer.Add() 配合 XElement.Load() 的重载，但更稳妥的是用 XNode.DeepClone() 后手动修正命名空间作用域：
XNamespace ns = "http://example.com"; var bRoot = b.Root; var cloned = new XElement(bRoot.Name, bRoot.Attributes(), bRoot.Nodes()); a.Root.Add(cloned);
- 不要直接
a.Root.Add(b.Root.Nodes())—— 命名空间未绑定到新父节点 - 若
b有默认命名空间，b.Root.Name.Namespace必须显式赋给新XElement - 属性中的命名空间（如
ns:attr="val"）需同步复制XAttribute，不能只靠Attributes()（它不包含带前缀的命名空间声明）
合并多个XML文件时，如何避免重复根名冲突？
XML 不允许同级出现两个相同名字的根元素。如果 a.xml 和 b.xml 都是 <config>...</config>，直接合并会导致结构非法。必须引入一个新容器，或重命名其中一个根。
推荐方案：统一包裹进新根，例如 <merged><config from="a.xml">...</config><config from="b.xml">...</config></merged>：
var merged = new XElement("merged");
foreach (var path in new[] { "a.xml", "b.xml" })
{
var doc = XDocument.Load(path);
var wrapper = new XElement(doc.Root.Name, doc.Root.Attributes(), doc.Root.Nodes());
wrapper.SetAttributeValue("from", path);
merged.Add(wrapper);
}
var result = new XDocument(merged);
- 不要试图删除原根再拼内容——会丢掉
xml:lang、xml:space等特殊属性 - 若业务强制要求单根，需提前约定“主文件”和“增量文件”，用
Elements()或Descendants()按路径合并具体节点，而非整树叠加 -
XDocument.Save()前务必检查merged.Nodes().Count()是否为 1，否则保存会失败
为什么 Save() 后文件变大、缩进混乱？
因为 XDocument.Save() 默认不格式化。看起来“乱”，其实是没写换行和缩进；但更隐蔽的问题是：多次加载-修改-保存，会不断累积空白文本节点（XText），尤其在有注释或 CDATA 的文件中。
- 保存前调用
doc.DescendantNodes().Where(n => n.NodeType == XmlNodeType.Whitespace).Remove();清理无意义空白 - 需要可读格式？用
doc.Save(TextWriter, SaveOptions.DisableFormatting)关闭自动格式化，再手动用XmlWriter控制缩进 - 生产环境建议禁用格式化：
doc.Save("out.xml", SaveOptions.DisableFormatting)，避免因空格差异引发签名或哈希校验失败
真正麻烦的从来不是怎么合并，而是合并后命名空间是否生效、空白是否可控、以及出错时异常堆栈里根本看不到是哪个文件哪一行坏了——所以加载阶段就要加 try/catch 并记录 path。
