Python minidom 怎样把另一份文档的节点复制进当前文档

用 xml.dom.minidom 合并两份 XML 时，关键不是直接调用目标文档的 appendChild()，而是先让目标文档执行 importNode(source_node, deep)。这个方法会返回一个属于目标文档的新副本，源节点仍留在原来的文档中；再把副本追加到目标根节点，就能完成跨文档复制。

官方文档：https://docs.python.org/3/library/xml.dom.minidom.html

最小可用写法是：copied = target.importNode(source_node, deep=True)，然后执行 target.documentElement.appendChild(copied)。需要后代节点时传 True，只要当前节点外壳时传 False。

先分清两棵 DOM 树

parseString() 返回一个 Document 对象。源 XML 和目标 XML 分别解析后，就拥有两棵独立的树。节点的 ownerDocument 记录它属于哪一个文档，因此源文档里的元素并不是目标文档可以直接接管的普通 Python 对象。

直接把源节点传给目标文档的 appendChild()，问题在于这一步没有完成“归属转换”。更稳妥的迁移顺序是：找到源节点、调用目标文档的 importNode()、选择复制深度、把返回的副本插入目标树。

用 importNode 复制后再插入

下面的例子把源文档中的 author 元素复制到目标文档的 library 根节点。代码里的中文注释只标出跨文档复制、深度选择和资源释放这几个关键点。

from xml.dom import minidom

source_xml = """林然"""
target_xml = ""

source = minidom.parseString(source_xml)
target = minidom.parseString(target_xml)

try:
    source_node = source.getElementsByTagName("author")[0]
    # 由目标文档创建副本，避免把源文档节点直接挂到另一棵树。
    copied = target.importNode(source_node, deep=True)
    # 导入后再插入目标根节点，副本的 ownerDocument 属于 target。
    target.documentElement.appendChild(copied)
    print(target.toxml())
finally:
    # minidom 提供 unlink()，不再使用时可尽早断开 DOM 内部引用。
    source.unlink()
    target.unlink()

这里的 deep=True 对 author 节点本身没有额外后代，但它表达了合并节点子树时的默认意图。如果源节点下面还有文本、子元素或注释，深复制会把这些后代一并带入目标树。importNode() 不会从源文档删除原节点，所以源树仍然可以继续读取。

deep 参数决定复制范围

deep=False 只复制当前节点；deep=True 才复制当前节点及其后代。选择错误时，最常见的表现是目标 XML 中只出现了标签名，却看不到原节点下的文本或子元素。

from xml.dom import minidom

source = minidom.parseString("A1")
target = minidom.parseString("")

try:
    item = source.getElementsByTagName("item")[0]
    # False 只保留 item 当前节点；True 递归复制 name 和 value。
    shallow = target.importNode(item, deep=False)
    deep = target.importNode(item, deep=True)

    print(len(shallow.childNodes))
    print(len(deep.childNodes))
finally:
    source.unlink()
    target.unlink()

浅复制适合先建立结构、后续再由目标文档补充内容的场景；深复制适合迁移一整段已经完整的 XML 子树。无论哪一种，返回值都是新节点，不能把它误认为源节点本身。

旧写法为什么需要调整

如果旧代码把多个解析结果混在一起，通常需要做三处调整：

这不是把 deep 当成“是否复制”的开关，而是复制范围开关：无论传入 False 还是 True，importNode() 都会返回副本；差别在于副本是否包含后代。

命名空间节点要保持同一套方法

如果 XML 使用命名空间，不要用普通标签名查找后再凭字符串拼接属性。目标文档仍然应该调用 importNode()，而需要创建新节点时使用 createElementNS() 等命名空间方法。这样能避免前缀、命名空间 URI 和元素层级在迁移过程中被混淆。

还要注意，minidom 是较小的 DOM 实现，Python 官方文档建议不熟悉 DOM 的用户优先考虑 xml.etree.ElementTree。如果任务只是顺序读取、修改少量标签，ElementTree 往往更简单；只有需要 DOM 的随机访问或节点级操作时，才保留这套导入流程。

发布前的迁移清单

1. 确认源节点和目标文档来自不同的 Document。
2. 始终调用目标文档的 importNode(source_node, deep)。
3. 需要完整子树时使用 deep=True，只要节点外壳时使用 False。
4. 把返回的副本追加到目标文档允许接收该节点类型的父节点。
5. 序列化前检查目标根节点是否仍然只有一个，并在处理完大文档后释放 DOM 引用。

常见问题

importNode 会把原节点从源文档剪切走吗？

不会。官方 DOM API 的语义是返回属于当前文档的副本，原节点仍留在源文档中。

为什么复制后看不到子元素？

优先检查是否传了 deep=False。如果需要后代节点，应改为 deep=True，并确认插入的是 importNode() 的返回值。

每次处理完都必须调用 unlink 吗？

不是强制要求。Python 的垃圾回收最终会处理对象；但对暂时不用的大 DOM，unlink() 或文档提供的上下文管理方式可以帮助更早释放内部引用。

把跨文档节点复制拆成“目标文档导入”和“目标父节点插入”两步，问题就会变得清晰：importNode() 负责副本与归属，appendChild() 负责树结构位置，deep 负责子树范围。