直接对 shadowRoot.innerHTML 赋值会导致样式不生效、脚本不执行、link 污染全局，唯一安全方案是用 template + cloneNode(true) 提取节点并分别注入 style/script，同时重写 DOM 查找逻辑为 shadowRoot.querySelector。
直接 innerHTML 赋值到 shadowRoot 会失效
这不是 bug，是浏览器行为规范：对 shadowRoot.innerHTML 直接赋值，<style> 不进 CSSOM，<script> 不执行，<link rel="stylesheet"> 会漏进 document.head，彻底破坏隔离。结果就是样式不生效、JS 初始化失败、CSP 报错。
- 永远不要写
shadowRoot.innerHTML = htmlString -
<style>必须显式调用shadowRoot.appendChild(styleEl) -
<script>需新建节点并appendChild到shadowRoot，否则执行上下文仍在全局 -
<link>绝不能出现在 innerHTML 字符串里——它无法被 Shadow DOM 拦截，会污染全局
template + cloneNode(true) 是唯一安全注入路径
把原始 HTML（含内联 <style> 和 <script>）塞进 <template>，再用 cloneNode(true) 拆解，才能保留节点结构与资源语义。这是目前唯一能兼顾脚本执行、样式加载和 CSP 合规的方案。
- 创建
const template = document.createElement('template')，再template.innerHTML = `<style>...</style><div>...</div>` - 用
template.content.cloneNode(true)获取纯净节点树 - 遍历克隆后的节点：遇到
<style>就shadowRoot.appendChild；遇到<script>就新建document.createElement('script')并设置textContent后追加 - 禁止拼接字符串生成
<style>——易漏转义，且无法处理<style type="text/css">等变体
第三方 JS 初始化总失败？根源在查找上下文错位
像 new Foundation() 或 Quill('#editor') 默认在 document 上找元素，但 shadow 内的节点根本不在主文档里。结果不是报错，而是静默失败——查不到容器，也不抛异常。
- 优先选用支持容器参数的 API：
new Quill(shadowRoot.querySelector('.ql-editor')) - 若框架不支持，必须包装初始化逻辑，把所有
document.querySelector替换为shadowRoot.querySelector - 禁用
$(document).ready()类钩子——它监听的是主文档就绪，和 shadow 内容无关 - 初始化时机建议用
setTimeout(() => { /* init */ }, 0)，确保 DOM 已挂载完毕；DOMContentLoaded在 shadowRoot 上不触发
mode: "open" 不是妥协，是生产必需
很多人误以为 mode: "closed" 更安全，其实它对样式隔离毫无增益，反而让调试、测试、CMS 预览全部瘫痪。真正起作用的是 Shadow DOM 机制本身，不是 mode。
立即学习“前端免费学习笔记（深入）”；
-
mode: "closed"下element.shadowRoot返回null，DevTools 看不到 #shadow-root，自动化脚本读不到内容 - CMS 编辑器插件依赖
shadowRoot做实时预览，closed模式直接使其失效 - 想用
:host或::slotted控制穿透样式？只有open才能验证是否生效 - 重复调用
attachShadow()会抛出Failed to execute 'attachShadow' on 'Element': Shadow root has already been attached，务必先检查element.shadowRoot === null
真正难的不是写对 attachShadow，而是把第三方 HTML 字符串里的 <style>、<script>、<link> 全部拆出来，分别注入到正确位置，并重写所有 DOM 查找逻辑——漏掉任何一个环节，隔离就形同虚设。
