解耦模板需三步：一是模板仅保留data-slot占位符，剔除所有if/for逻辑；二是服务端返回自洽HTML片段，确保语义完整与样式隔离；三是前端用template+cloneNode安全挂载，避免innerHTML副作用。
模板里别写 if/for 逻辑，只留 slot 占位符
服务端模板（如 EJS、Nunjucks）里直接写 <% if (user.role === 'admin') { %> 是最常见也最危险的耦合点——HTML 结构从此依赖运行时数据，无法静态分析、无法预编译、缓存粒度被迫拉到整个页面。真正解耦的第一步，是把模板变成“纯结构容器”。
只允许出现语义中立的占位符，比如：<main data-slot="content"></main>、<aside data-slot="sidebar"></aside>。所有条件渲染、循环列表、角色判断，全部移出模板，交给服务端组合层处理。
- 错误写法：
<% users.forEach(u => { %><div class="user"><%= u.name %></div><% }) %>—— 模板和数据格式强绑定，换个字段名就得改 HTML - 正确做法：服务端生成一份 JSON 数据，例如
{ "content": "<div class="user">Jim</div>" }，再用轻量函数注入到对应data-slot元素内 - 好处：模板可独立缓存；AB 测试只需换 JSON；前端也能复用同一份 HTML 结构做 hydration
用 data-slot + dataset 驱动内容挂载，而非 class 或 id
靠 class="sidebar" 或 id="user-list" 定位挂载点，本质是把 DOM 结构和业务逻辑绑死。一旦改样式类名或重构模块，JS 就得同步改查询逻辑，解耦就失效了。
统一用 data-slot 属性作为挂载契约，既不干扰样式，也不污染语义，且天然支持多实例：
立即学习“前端免费学习笔记（深入）”；
文章转信息图。将文章/笔记转化为手机可读的 HTML 信息图，自动匹配视觉风格。触发场景：文章转图、笔记转图、信息图、转小红书图、做张图、可视化这篇文章、文生图。
- HTML 中：
<div data-slot="dashboard-stats"></div> - 服务端返回 JSON：
{"dashboard-stats": "<div>...</div>"} - 挂载逻辑：
document.querySelector('[data-slot="dashboard-stats"]').innerHTML = data['dashboard-stats'] - 优势：增删模块只需改 JSON 键名，HTML 和 JS 都不用动；多个同名
data-slot可批量处理，适合仪表盘多卡片场景
避免 innerHTML 直接插入，优先用 template + cloneNode
直接赋值 el.innerHTML = htmlString 看似简单，但会丢失已绑定事件、破坏已有 DOM 引用、触发重复解析，尤其在动态更新频繁的大屏场景下容易引发内存泄漏或状态错乱。
更安全的做法是把 HTML 字符串提前编译为 <template> 节点，再用 cloneNode(true) 注入：
- 模板定义：
<template id="stats-card"><div class="card"><h3 data-bind="title"></h3><p data-bind="value"></p></div></template> - 挂载时：
const tpl = document.getElementById('stats-card'); const node = tpl.content.cloneNode(true); node.querySelector('[data-bind="title"]').textContent = 'UV'; el.appendChild(node); - 关键点：template 不会渲染，无性能开销；cloneNode 保留事件监听器原型链；data-bind 属性可配合 dataset 统一提取，不硬编码 DOM 路径
服务端返回的 HTML 片段必须自带完整语义和样式隔离
很多人以为“模板只留 slot，内容由服务端拼进去”就算解耦完成，忽略了拼进去的内容本身是否自洽。如果返回的 HTML 片段里还带着全局 class、未封装的 style 标签、或依赖外部 JS 的 onclick，那只是把耦合从模板挪到了片段里。
每个服务端返回的 HTML 片段应满足：
- 使用 Web Components 封装：推荐用
customElements.define()注册，内部调用this.attachShadow({ mode: 'open' })，确保样式与结构完全隔离 - 若用传统 HTML 片段：必须包含完整 class 命名空间（如
stats-card__title），禁用内联style和onclick，所有行为通过data-behavior+ 事件委托驱动 - 禁止返回仅含
<div>xxx</div>这类裸节点——它没有语义、没有样式上下文、无法单独测试或复用
真正的解耦不是让 HTML “空”，而是让它“自足”。一个 data-slot="sales-chart" 对应的片段，应该能脱离当前页面独立运行、可无障碍访问、可被搜索引擎识别——否则，slot 只是把耦合藏得更深了。
