必须先用目标文档的importNode()导入克隆节点才能插入，因为cloneNode()仅复制结构且节点仍归属原文档；importNode()才真正将节点及其子树（deep=true时）迁移至新文档并返回新归属节点。
cloneNode() 会复制节点但不自动关联到新文档
Java DOM 中 cloneNode() 只做浅拷贝或深拷贝，不会处理跨文档引用。如果原节点属于 Document A，克隆后仍“归属”于 A —— 直接 appendChild() 到 Document B 会抛 DOMException: WRONG_DOCUMENT_ERR。
关键点在于：DOM 规范要求节点只能被其所属文档（ownerDocument）的 API 操作。所以必须先用目标文档的 importNode() 中转。
-
cloneNode(true)复制子树，但结果仍是原文档的节点 - 必须调用目标
Document.importNode(clonedNode, true)才能合法插入 -
importNode()返回的是新文档中的等价节点，和原节点无引用关系
importNode() 的 deep 参数决定是否递归导入子节点
importNode() 第二个布尔参数 deep 控制是否导入整个子树。它不是“是否克隆”，而是“是否把后代节点也迁移到新文档”。即使传 false，导入的节点本身仍是新文档的合法节点（只是没有子节点）。
常见误用：以为 importNode(node, false) 能省性能，其实它只导入当前节点，若后续要操作子节点，仍需单独导入或重新获取。
立即学习“Java免费学习笔记（深入）”；
- 想完整迁移一个
Element及其全部子元素、文本、属性 → 用true - 只导入空元素占位（如仅保留标签名和属性，丢弃内容）→ 用
false -
importNode()总是返回新文档中的节点，原节点不受影响
典型流程：克隆 + 导入 + 插入三步不能少
实际代码中漏掉 importNode() 是最常见错误。下面是一个安全迁移节点的最小闭环：
Document sourceDoc = ...;
Document targetDoc = ...;
Element sourceElem = (Element) sourceDoc.getElementsByTagName("data").item(0);
Element cloned = (Element) sourceElem.cloneNode(true); // 还属于 sourceDoc
// ✅ 必须导入
Element imported = (Element) targetDoc.importNode(cloned, true);
// ✅ 现在可以插入
targetDoc.getDocumentElement().appendChild(imported);
注意：importNode() 不修改原节点，也不修改克隆节点；它新建一个逻辑等价但归属不同的节点。如果你跳过这步直接 targetDoc.appendChild(cloned)，JDK 的 Xerces 实现会明确报错：org.w3c.dom.DOMException: WRONG_DOCUMENT_ERR。
特殊节点类型要注意兼容性
不是所有节点都能无损导入。比如 DocumentType、Entity、Notation 在部分 JDK 版本（尤其是早期 1.6/1.7）中可能被忽略或抛 NOT_SUPPORTED_ERR。而 Attr 节点在导入时会被自动附加到对应 Element 上（无需手动 setAttributeNode()）。
-
Text、Element、Comment安全，几乎无坑 -
DocumentFragment可导入，但需确保其子节点也支持导入 - JDK 8+ 对命名空间节点（带 prefix/nsURI）支持更稳；JDK 6 下
importNode()可能丢失 namespace 声明
跨文档操作的本质是节点所有权转移，DOM API 不提供“一键搬家”，cloneNode 和 importNode 各司其职——前者复制结构，后者变更归属。漏掉任一环节，都会卡在文档边界上。
