必须用 template.content.cloneNode(true) 才能稳定渲染列表，因 template.content 是只读 DocumentFragment，innerHTML 恒为空；直接 appendChild 会搬空内容，浅克隆丢失子节点与表单状态；填值须用 textContent/value 而非 innerHTML 防 XSS；批量插入需用 DocumentFragment 中转以避免重排重绘。
直接用 template.content.cloneNode(true) 是唯一能稳定渲染列表的方式，其他路径基本都会在第二条数据时静默失败。
为什么 template.innerHTML 总是空字符串
因为 template 的内容被封装在只读的 DocumentFragment 里，不是普通 DOM 子树。浏览器规范强制隔离这部分内容，所以：
• template.innerHTML 永远返回空字符串
• template.children 是空 NodeList
• template.textContent 只返回纯文本（含换行缩进），无法操作结构
必须走 template.content 这个入口，别绕路
克隆必须用 cloneNode(true)，浅克隆或不克隆都出问题
常见错误现象：
• 第二次渲染空白，控制台无报错
• 所有列表项显示相同数据
• 输入框光标丢失、选中状态归零
• 表单值没更新，但 DOM 看起来“填进去了”
原因：
• template.content 是移动语义：直接 appendChild(template.content) 会把内容“搬走”，第二次调用就为空
• cloneNode(false) 只克隆顶层元素，子节点全丢，表单控件、事件监听器、文本节点全失效
• cloneNode(true) 才能复制全部子节点、属性、文本和表单当前值，保留可编辑状态
将调研报告、方案对比、数据分析、需求梳理、会议纪要、设计说明、代码评审、学习笔记等任务产物输出为可在浏览器直接打开的单文件 HTML，替代 Markdown 作为最终交付物。Markdown 在信息密度、视觉清晰度和可分享性上已跟不上 AI 产物的丰富度，HTML 能同时承载排版、表格、SVG 等。
填值别碰 innerHTML，优先用 textContent 和 value
用 innerHTML 填用户数据等于主动引入 XSS 风险，还会清空模板里已绑定的事件监听器（比如 onclick 或手动加的 addEventListener）：
• 纯文本内容 → el.querySelector('.title').textContent = data.title
• 表单控件 → el.querySelector('input').value = data.inputValue（不是 textContent）
• 需要渲染富文本？先对输入做 HTML 转义（如 text.replace(/&/g, '&')），再塞进 innerHTML
• 模板里含 <script> 或 <style>？克隆后它们依然不执行、不生效——别指望“活”过来
立即学习“前端免费学习笔记（深入）”；
批量插入必须走 DocumentFragment 中转
循环里每轮都 container.appendChild(cloned)，浏览器就得反复重排重绘：
• 100 条数据就可能卡顿
• 500 条基本卡死
正确做法：
• const frag = document.createDocumentFragment()
• 循环体内：克隆 → 填值 → frag.appendChild(cloned)
• 循环结束后，只调一次 container.appendChild(frag)frag 是轻量中间对象，不在主 DOM 树中，querySelector 查不到它，也不触发样式计算或布局，性能恒定。这点容易被忽略，但它是中等规模列表（200–1000 条）不卡的关键。
