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 字节来确定编码。如果 <meta charset="UTF-8"> 被 <title></title> 或注释挡在后面,fetch 返回的 JSON 中文字段、document.title 全部变方框,刷新也救不回来。
-
<meta charset="UTF-8">必须是的第一个标签,前面不能有任何东西(包括空行、注释、BOM) - 别写
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">——HTML5 已废弃,Chrome 120+ 直接忽略 -
<title></title>是强制字段:没它,标签页显示“无标题文档”,爬虫当废页,微信 WebView 默认显示域名
挂载容器 id="app" 为什么总被清空或报错?
React/Vue/Angular 都靠这个节点启动,但很多人在里面塞了 <h1>Loading</h1>,结果框架初始化时整个清空,造成闪烁或 DOM mismatch。
立即学习“前端免费学习笔记(深入)”;
- 挂载容器必须为空、唯一、带
id:<div id="app"></div>或<main id="root"></main> - 不能用 class 替代 id:
.app会匹配多个节点,createApp().mount('#app')明确要求 CSS ID 选择器 - 若用
history.pushState,必须加<base href="/>%EF%BC%8C%E5%90%A6%E5%88%99%20./assets/main.js%20%E8%BF%99%E7%B1%BB%E7%9B%B8%E5%AF%B9%E8%B7%AF%E5%BE%84%E5%9C%A8%E5%AD%90%E8%B7%AF%E7%94%B1%E4%B8%8B%20404 %0A
%E6%9C%AC%E5%9C%B0%E5%8F%8C%E5%87%BB%E6%89%93%E5%BC%80%20index.html%20%E4%B8%BA%E5%95%A5%20fetch%20%E6%8A%A5%20CORS%20%E9%94%99%E8%AF%AF%EF%BC%9F
%0Afile://%20%E5%8D%8F%E8%AE%AE%E4%B8%8B%E6%89%80%E6%9C%89%E8%B7%A8%E6%96%87%E4%BB%B6%E6%93%8D%E4%BD%9C%E9%83%BD%E8%A2%AB%E6%B5%8F%E8%A7%88%E5%99%A8%E6%8B%A6%E6%88%AA%EF%BC%9Afetch%E3%80%81import()%E3%80%81<link%20rel=" stylesheet> 全部失效,报错类似 Access to script at 'file:///xxx' from origin 'null' has been blocked。
- 永远不要双击打开 SPA 入口——必须走本地服务器,比如 VS Code 的
Live Server插件 - 静态资源路径统一用相对路径(如
./js/app.js),避免硬写http://或./assets/却没建对应目录 - SPA 的首屏 HTML 必须含真实内容,
<title></title>和初始 DOM 不能靠 JS 后续注入,否则 SSR hydration 会报 DOM mismatch
最常被跳过的其实是 DOCTYPE 顶格和 meta charset 的绝对前置——这两个点一旦出错,后续所有 JS 调试都是在修表象,根子早断了。



















