DOCTYPE和lang属性必须顶格写,否则触发怪异模式;meta charset须为head首个标签且UTF-8无BOM;lang值需符合BCP 47;title不可缺失;挂载容器须为空、唯一、带id;静态资源用相对路径;第三方库硬写在index.html中。

单页应用(SPA)调试不等于“打开控制台看报错”,真正卡住人的往往是 HTML 入口文件本身没写对,导致 JS 根本没机会执行、路由挂掉、fetch 返回乱码、甚至页面白屏都查不出原因。
为什么 index.html 一开就进怪异模式?
浏览器读到第一个非空白字符就决定渲染模式。哪怕开头是 BOM(EF BB BF)、空格或注释,IE 和微信 WebView 就强制触发 Quirks Mode——box-sizing 失效、position: sticky 不工作、getBoundingClientRect() 返回 NaN。
- 用 VS Code 打开
index.html,右下角确认编码是 UTF-8(不是 UTF-8 with BOM) - 终端运行
hexdump -C index.html | head -n 1,前三个字节必须是3c 21 44(即) -
lang值必须符合 BCP 47:写lang="zh-CN",别写lang="zh"或lang="cn"
meta charset 放错位置会直接导致中文乱码
浏览器只扫描 前 1024 字节来确定编码。如果 被 或注释挡在后面,fetch 返回的 JSON 中文字段、document.title 全部变方框,刷新也救不回来。
-
必须是的第一个标签,前面不能有任何东西(包括空行、注释、BOM) - 别写
——HTML5 已废弃,Chrome 120+ 直接忽略 -
是强制字段:没它,标签页显示“无标题文档”,爬虫当废页,微信 WebView 默认显示域名
挂载容器 id="app" 为什么总被清空或报错?
React/Vue/Angular 都靠这个节点启动,但很多人在里面塞了 ,结果框架初始化时整个清空,造成闪烁或 DOM mismatch。Loading
- 挂载容器必须为空、唯一、带
id:或 - 不能用 class 替代 id:
.app会匹配多个节点,createApp().mount('#app')明确要求 CSS ID 选择器 - 若用
history.pushState,必须加全部失效,报错类似Access to script at 'file:///xxx' from origin 'null' has been blocked。- 永远不要双击打开 SPA 入口——必须走本地服务器,比如 VS Code 的
Live Server插件 - 静态资源路径统一用相对路径(如
./js/app.js),避免硬写http://或./assets/却没建对应目录 - SPA 的首屏 HTML 必须含真实内容,
和初始 DOM 不能靠 JS 后续注入,否则 SSR hydration 会报 DOM mismatch
最常被跳过的其实是
DOCTYPE顶格和meta charset的绝对前置——这两个点一旦出错,后续所有 JS 调试都是在修表象,根子早断了。 - 永远不要双击打开 SPA 入口——必须走本地服务器,比如 VS Code 的
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











