C# 合并 xml 文档需据需求选择方式：场景一追加子节点，场景二按名 / 属性覆盖合并，场景三嵌入为子元素；注意 编码 、 命名空间 及大文件流式处理。
在 C# 中合并两个 XML 文档，关键在于明确“合并”的具体含义：是简单拼接根节点下的子元素，还是按节点名称 / 属性智能合并（如相同 ID 的节点取新值），或是将一个 XML 作为子节点插入另一个。不同需求对应不同实现方式，下面分几种常见场景说明。
场景一：将第二个 XML 的所有子节点追加到第一个 XML 的根节点下
适用于结构兼容、只需“拼起来”的情况，比如合并多个配置片段。
- 用 XDocument.Load() 分别加载两个 XML
- 获取第一个文档的根元素（Root）
- 调用 Root.Add(secondDoc.Root.nodes())，把第二个文档根下的所有节点（元素、文本等）添加进去
- 注意：如果第二个 XML 有声明（
<?xml version="1.0"?>）或注释，Nodes() 会包含它们；若只需元素，改用 Root.Elements()
场景二：按节点名合并（同名节点内容覆盖或合并）
例如两个 XML 都有 <user id="100"></user>，希望用第二个中的值更新第一个中的对应节点。
- 遍历第二个 XML 的 Root.Elements()
- 在第一个 XML 中查找同名（或按特定属性如
id）匹配的节点：firstDoc.Root.Elements().FirstOrDefault(x => x.Attribute(“id”)?.Value == “100”) - 存在则替换其内容（ReplaceNodes()）或属性；不存在则 Add() 新节点
- 建议 封装 成方法，传入匹配逻辑（Func
）更灵活
场景三：将整个 XML 作为子元素嵌入（保持结构隔离）
适合把一个 XML 当“模块”插入另一文档的指定位置，避免命名冲突。
- 加载两个文档后，用 new XElement(“section”, secondDoc.Root.Nodes()) 包裹第二个 XML 的内容
- 再插入到第一个 XML 的目标位置，例如：firstDoc.Root.Element(“body”).Add(wrapped)
- 也可直接用 firstDoc.Root.Add(new XElement(“import”, secondDoc.ToString())) 存为 CDATA 或 字符串（需转义）
注意事项和小技巧
合并前建议检查 编码 一致性（如都用 UTF-8），避免保存时报错；若 XML 含命名空间，需确保 XNamespace 一致，否则 Elements() 可能找不到节点；对大文件，考虑用 XmlReader/XmlWriter 流式处理，避免全载入内存。
