importNode 安全迁移跨文档节点需目标文档调用，源节点必须来自另一文档；deep 参数控制子树导入深度，true 导入全部后代，false 仅导入自身；完整流程为获取源节点→目标文档 importNode→插入目标位置。
要用 importNode 安全迁移并克隆跨 Document 实例的 DOM 节点，关键不是“先克隆再迁移”，而是“先确保源节点归属明确，再用目标文档的 importNode 一次性导入”。它本质是所有权转移的复制操作，不是普通克隆。
明确谁调用、谁提供节点
必须由**目标文档对象**（比如主页面的 document 或 iframe 的 contentDocument）调用 importNode()；传入的节点必须来自另一个文档（如 iframe、DOMParser 解析结果、或 ShadowRoot 内部文档）。不能把当前文档的节点传给自己调用的 importNode——这属于冗余操作，部分浏览器会静默失败或行为不一致。
- ✅ 正确：从 iframe 取节点 → 用主
document.importNode(node, true) - ✅ 正确：用
new DOMParser().parseFromString(html, 'text/html')得到新文档 → 用该文档的importNode导入到主文档 - ❌ 错误：
document.importNode(document.getElementById('x'), true)—— 源和目标是同一文档，应直接cloneNode
深拷贝参数 deep 控制子树迁移范围
deep 是布尔值，决定是否把整个子树（含所有后代节点）一并导入。它不控制“是否克隆”，而控制“导入多深”：
-
true：导入节点及其全部子节点，生成完整副本结构；但事件监听器、onxxx属性、自定义元素实例、Shadow Root 均丢失（纯结构迁移） -
false：只导入该节点本身（如一个空<div id="box"></div>），不含任何子内容；适合做占位容器或后续手动填充
注意：即使 deep = false，返回的节点也已是目标文档合法成员，可安全插入或设置属性。
根据 package.json 中的 engines 字段自动检测 Node.js 版本需求，未安装 nvm 时自动安装并切换至对应版本。支持 Windows、macOS、Linux。适用于 Node.js 项目开发、版本切换和环境配置。
完整迁移三步不可省略
尤其在 Java DOM 或严格模式 JS 中，漏掉任一环节都会报 WRONG_DOCUMENT_ERR。标准流程是：
- 获取源节点（确保它确实来自另一文档，例如
iframe.contentDocument.querySelector('.item')） - 调用目标文档的
importNode(sourceNode, true)→ 返回新节点，ownerDocument已切换为目标文档 - 将返回节点插入目标位置（如
targetContainer.appendChild(importedNode)）
不要试图跳过 importNode 直接 appendChild 源节点，浏览器会拒绝。
template.content 和 DocumentFragment 的特殊处理
<template> 的 content 是 DocumentFragment，它没有 cloneNode() 方法，也不能直接插入。此时 importNode 是合规解法：
- ✅
document.importNode(template.content, true)—— 安全克隆整个模板内容（现代浏览器支持稳定） - ⚠️ 避免
template.content.cloneNode(true)—— 报错：TypeError: cloneNode is not a function - ? 若模板在 iframe 中，必须用 iframe 的
contentDocument.importNode(...)，不能混用
导入后需手动处理内联 <script> 或 <style>（它们不会自动执行或生效）；如有自定义元素，还需调用 customElements.upgrade(importedNode)。
