Node.js多层架构中HTML模板不能原样在沙箱渲染，必须三段式处理：服务端模板输出→安全剥离/转义→沙箱内DOM构建；跳过清洗环节的innerHTML或document.write会绕过CSP、触发XSS或静默失败。
直接说结论：Node.js 多层架构中，HTML 模板不能直接在沙箱（如 vm2、Worker 或 iframe）里“原样渲染”，必须拆解为三段式处理：服务端模板输出 → 安全剥离/转义 → 沙箱内 DOM 构建。任何跳过中间清洗环节的 innerHTML 或 document.write 都会绕过 CSP、触发 XSS 或静默失败。
服务端模板输出时，template.HTML 不等于安全
Go 的 html/template 或 Node.js 的 handlebars 默认对变量做 HTML 转义，但沙箱环境（比如微前端子应用或 iframe 预览页）往往需要原始 DOM 结构绑定事件——这时有人用 template.HTML 或 {{{raw}}} 绕过转义，却忘了后续环节没做清洗。
- 绕过转义只适用于**可信来源内容**（如后端构造的静态脚本），不适用于用户输入拼接的 HTML
-
template.HTML在 Node.js 侧无对应类型，需手动用res.send(unescapeHtml(userInput))+ 白名单标签过滤，而非简单res.send(userInput) - 若沙箱启用
Content-Security-Policy: script-src 'self'，即使绕过转义，<script>也会被浏览器拦截，应改用nonce或预注册函数
vm2 沙箱里不能直接操作 DOM，得靠主线程代理
vm2 的 VM 和 NodeVM 运行在 V8 上下文，不提供 document、HTMLElement 等 DOM API。试图在沙箱内调用 document.createElement 会直接报 ReferenceError: document is not defined。
- 正确做法是：沙箱内只做数据计算和结构生成（如返回一个纯对象描述 DOM 树），由主线程用
DOMParser或template.content.cloneNode(true)构建真实节点 - 避免在沙箱里拼接字符串再传给主线程执行
innerHTML—— 这等于把 XSS 风险外包给主线程 - 若必须动态注入，主线程应使用
createContextualFragment（现代浏览器）或降级为DOMParser解析，而非innerHTML
iframe 沙箱渲染时，<template> 必须克隆才能复用
浏览器原生 <template> 的 content 是只读 DocumentFragment，直接 appendChild(tmpl.content) 第二次就会失效——因为第一次移走后它就空了。
将调研报告、方案对比、数据分析、需求梳理、会议纪要、设计说明、代码评审、学习笔记等任务产物输出为可在浏览器直接打开的单文件 HTML，替代 Markdown 作为最终交付物。Markdown 在信息密度、视觉清晰度和可分享性上已跟不上 AI 产物的丰富度，HTML 能同时承载排版、表格、SVG 等。
立即学习“前端免费学习笔记（深入）”；
- 每次插入前必须调用
tmpl.content.cloneNode(true)，否则第二次 append 什么都不会出现，也不报错 -
<slot>在普通 iframe 文档中无效，仅对ShadowRoot生效；若沙箱不是 Shadow DOM，需提前用 JS 替换<slot>为实际内容 - iframe 内若用
srcdoc注入 HTML，注意其长度限制（Chrome 约 16MB，但部分旧版 Safari 仅 2MB），超长需改用 blob URL
多层架构中，模板渲染链路容易漏掉的清洗点
典型链路是：数据库 → Node.js 模板引擎 → HTTP 响应 → iframe 沙箱 → 主线程 DOM 插入。问题常出在“HTTP 响应”到“iframe 沙箱”之间——这个环节没人负责清洗。
- 后端模板输出的 HTML 可能含
onerror=alert(1)、javascript:alert()等危险属性，CSP 不拦截 inline handler，得靠正则或DOMPurify.sanitize()清洗 - 微前端场景下，主应用把子应用 HTML 注入 iframe 前，若没调用
DOMPurify.sanitize(html, { USE_PROFILES: { html: true } })，等于主动开放 XSS 入口 - Node.js 层若用
res.send(htmlString)直接吐出未清洗 HTML，前端再用DOMParser解析也晚了——恶意脚本可能已在解析阶段执行（取决于浏览器实现）
真正难的不是怎么渲染，而是每一层都得明确自己负责哪一段清洗：模板引擎管变量转义，HTTP 中间件管响应体过滤，iframe 加载前管 DOM 结构净化，主线程管最终节点挂载方式。少一环，沙箱就形同虚设。
