HTML模板结构必须先于框架挂载点存在，否则mount()会因DOM未就位而报错或空白；需确保挂载容器在body内靠前、避免head中定义、验证document.querySelector('#app')存在，并注意各在线平台解析差异及file://协议限制。
HTML模板结构必须先于框架挂载点存在
Vue、React 或 Svelte 的初始化逻辑依赖 DOM 元素已就位，如果 mount('#app') 执行时 <div id="app"></div> 还没被解析，就会报错或静默失败。常见错误现象是控制台出现 TypeError: Cannot mount app on element with selector "#app" 或页面空白。
- 确保模板中挂载容器写在
<body>内且位置靠前，不要放在<script>标签之后 - 避免在
<head>里写挂载用的 HTML 结构（浏览器会自动移到<body>开头，但顺序不可控） - 若用构建工具生成 HTML，检查模板是否被插件（如 HtmlWebpackPlugin）覆盖或注入时机不对
- 在 JS 中加
console.log(document.querySelector('#app'))验证元素是否存在，比直接调用mount()更早暴露问题
在线调试平台对 HTML 模板的解析差异要手动验证
CodePen、CodeSandbox 和 JSFiddle 对 HTML 的处理方式不同：CodePen 默认包裹一层 <div class="pen-parent">，可能干扰 CSS 选择器；CodeSandbox 默认启用模块化加载，<script type="module"> 下的全局变量不会自动挂到 window；JSFiddle 则默认把 JS 放在 onload 里执行，延迟 DOM 就绪。
- 在 CodePen 中测试挂载逻辑，先确认
document.getElementById('app')能取到，再调用框架方法 - CodeSandbox 中若用 Vue CDN，需显式使用
Vue.createApp(...).mount(...)，不能依赖new Vue()（已废弃） - JSFiddle 的 “JavaScript” 区域设置为 “No wrap - in <head>” 时，
document.querySelector可能返回null，改选 “No wrap - in <body>” - 所有平台都建议在 HTML 区域顶部加
<meta name="viewport" content="width=device-width, initial-scale=1">，否则移动端预览失真
开发者工具 Elements 面板看到的不是你写的 HTML
浏览器会自动修正错误嵌套、补全缺失标签、移除非法子元素——比如把 <p><div>xxx</div></p> 拆成两个兄弟节点。这意味着你写的模板和最终参与框架挂载的 DOM 可能不一致。
- 不要只看源码，要在 Elements 面板里右键目标容器 → “Edit as HTML”，粘贴修改后观察实时渲染变化
- 用
document.body.innerHTML在 Console 输出当前真实 DOM，和原始 HTML 字符串做 diff - 框架组件内
v-if或ngIf控制的节点，在 Elements 中可能根本不存在，别误判为模板漏写 - 如果用了 SSR 或静态生成（如 Vite 预渲染），Elements 显示的是服务端吐出的 HTML，不是客户端 JS 渲染结果，需切换到 “Console” 看
app._instance等内部状态
本地 file:// 协议下 HTML 模板无法加载外部资源
直接双击打开 HTML 文件走 file:// 协议，fetch、<link rel="stylesheet">、甚至某些 <script src> 会被同源策略拦截，导致样式丢失、JS 报 404、Vue 组件无法解析 —— 这不是模板问题，是协议限制。
立即学习“前端免费学习笔记（深入）”；
- 启动本地服务器：用
npx serve（需 Node.js）、python3 -m http.server 8000或 VS Code 的 Live Server 插件 - 确认地址栏是
http://localhost:8000/xxx.html而不是file:///xxx.html - CDN 引入的框架脚本（如
https://unpkg.com/vue@3/dist/vue.global.js）在file://下通常能加载，但自定义 CSS/JS 文件路径会失败 - W3C 验证器或 Lighthouse 审计必须在 HTTP 环境下运行，
file://会跳过资源校验，掩盖真实问题
模板和调试工具之间没有自动适配层，每个环节都要亲手确认 DOM 是否如你所想、资源是否按预期加载、框架是否真的绑定了你写的那个 id。最容易被忽略的是：你以为改了 HTML 模板，其实浏览器已经帮你重写了它。
