直接用 fetch 加载 html 片段易致白屏、越权访问、脚本不执行及 js 冲突；template 不适合跨文件复用；推荐构建时静态合并+运行时动态挂载，或使用 web components 实现隔离热插拔。
为什么直接用 fetch 加载 HTML 片段在后台系统里容易出问题
因为后台管理系统通常要求首屏内容完整、SEO 无关但交互强、权限控制粒度细，而裸 fetch('nav.html').then(...) 会带来三类硬伤：首次渲染空白（白屏几秒）、权限校验缺失（加载了不该看的菜单）、脚本不执行（<script></script> 标签被当纯文本插入）。更麻烦的是，不同模块的 JS 依赖可能冲突，比如两个 nav.html 都引入了同名 initMenu()，后者直接覆盖前者。
<template></template> 标签不是“热插拔”方案，别把它当 include 用
<template></template> 的 content 是文档片段，不解析、不执行、不触发样式/脚本——它只适合单页内高频克隆同一结构（如表格行、弹窗），不适合跨文件复用导航栏或侧边栏。常见误用是把整个左侧菜单塞进 <template id="sidebar"></template>，再用 JS 插入，结果：document.getElementById('sidebar').content 在 DOM ready 前取不到，或者插入后 addEventListener 绑定失效（事件委托没配好）。
-
<template></template>必须放在外层（即文档根级），嵌在<div> 里就无效 <li>克隆后需手动遍历子节点绑定事件，不能靠 <code>innerHTML = ...一劳永逸 - 没有加载失败兜底机制，网络中断时页面直接缺一块
真正能热插拔的方案：构建阶段预合并 + 运行时动态挂载
后台系统要兼顾开发效率和运行时可控性，得拆成两步走：构建时把 header.html、sidebar.html 等片段静态合并进最终 HTML（解决首屏、SEO、CSP 限制），再用轻量 JS 控制模块显隐和数据注入（解决权限、状态同步）。例如用 posthtml-include：
<include src="/partials/sidebar.html"></include>
配合 Webpack 的 html-webpack-plugin 和自定义 preprocessor，让构建输出的 index.html 已含完整结构，但所有模块容器带 data-module="user-list" 属性。运行时只需：
将 Markdown 文章转换为微信公众号兼容的纯 HTML 格式。当用户要求"转成微信格式"、"生成公众号文章 HTML"、"排版到微信草稿箱"、"微信粘贴格式"时触发。输出带内联样式的纯 HTML，微信编辑器可直接渲染，无需额外适配。支持标题、段落、列表、粗体、行内代码、表格、引用块、代码块、配图的完整转换。
const moduleEl = document.querySelector('[data-module="user-list"]');<br>if (hasPermission('user:read')) {<br> moduleEl.innerHTML = renderUserList(data); // 渲染逻辑独立封装<br>} else {<br> moduleEl.remove();<br>}
- 片段文件不能含
或，否则生成 HTML 会嵌套错乱 -
src路径必须相对于项目根目录，不是相对于当前 HTML 文件 - 权限判断必须在
innerHTML之前，避免 DOM 插入后再删，造成闪动
Web Components 是唯一能兼顾隔离与热插拔的原生方案
如果你的后台系统需要第三方模块（比如财务插件、BI 图表组件）动态加载且互不干扰，customElements.define() 是目前最干净的选择。它天然支持 Shadow DOM 隔离样式、独立生命周期、属性传参：
<admin-sidebar permissions='["user:read", "role:edit"]'></admin-sidebar>
注册逻辑里做权限过滤和懒加载：
class AdminSidebar extends HTMLElement {<br> connectedCallback() {<br> const perms = JSON.parse(this.getAttribute('permissions') || '[]');<br> if (!perms.includes('user:read')) return;<br> this.attachShadow({ mode: 'open' }).innerHTML = `<nav>...</nav>`;<br> }<br>}<br>customElements.define('admin-sidebar', AdminSidebar);
- IE 完全不支持，Edge 79+ 才稳定，旧系统必须加
@webcomponents/webcomponentsjspolyfill -
connectedCallback不要操作document.body，否则破坏封装性 - 传参只能是字符串或布尔值，复杂对象得序列化，别传函数引用
真正的热插拔难点不在怎么加载，而在模块间状态同步和错误隔离——一个 sidebar 模块崩溃，不能让整个 admin 页面白屏。这需要每个自定义元素自己处理异常，而不是靠全局 try/catch。
