HTML5文档声明必须是，且必须位于文件最开头、无任何前置字符，否则触发怪异模式导致布局、JS、API异常；常见错误包括BOM、XML声明、模板覆盖或编码问题。
HTML5 文档声明必须是
这是唯一被现代浏览器认可的 HTML5 文档类型声明，不区分大小写，但惯例全小写。它必须出现在文档最开头，前面不能有任何字符（包括空格、BOM、注释）。一旦漏写或写错，比如写成 （看似一样，但某些编辑器可能插入不可见 BOM）或混入 XML 声明，浏览器就会触发怪异模式（Quirks Mode），导致 CSS 盒模型、字体渲染、JS 行为全部不可预测。
常见错误现象：document.body.clientHeight 返回 0、flex 布局完全失效、position: sticky 不生效——往往不是代码问题，而是 DOCTYPE 缺失或位置不对。
- 不要写
：那是 HTML4 的，会降级到几乎无用的兼容模式 - 不要在它前面加
<?xml version="1.0" encoding="UTF-8"?>：XML 声明 + HTML5 DOCTYPE 是非法组合，IE 和部分移动端直接拒解析 - 检查文件编码是否含 BOM：UTF-8 with BOM 的文件，即使只写了
，开头三个字节 <code>EF BB BF也会让浏览器忽略该声明
为什么不用系统识别或自动补全
浏览器不“猜”你用什么标准——它只看有没有 ，以及它是否在第一行首字符位置。没有，就默认回退到 IE5.5 的渲染逻辑；有，才启用 HTML5 的语义解析、新 API（如 <code>dataset、contenteditable）、表单验证等能力。
这跟 JS 引擎是否支持 const 或 CSS 是否支持 gap 不同：那些是运行时能力检测，而 DOCTYPE 是解析器启动开关。开关没开，后续所有新特性都加载不到上下文里。
立即学习“前端免费学习笔记（深入）”；
-
<input type="date">在无 DOCTYPE 时只是个普通文本框，不会弹出日期选择器 -
localStorage虽然仍可用，但sessionStorage在某些旧 Android WebView 中会静默失败 - CSS 中
rem单位计算可能基于错误的根字体大小（因盒模型错乱间接影响）
实际项目中容易被忽略的几个点
不是写完 就万事大吉。真实工程里它常被模板引擎、构建工具或静态站点生成器悄悄覆盖或截断。
- 使用 EJS / Pug / Jinja2 时，确认 layout 模板里 DOCTYPE 是硬编码的，而不是靠变量拼接（如
可能为空） - Vite / Webpack 的 HTML 插件如果配置了
template，要检查该文件本身是否已含正确 DOCTYPE；否则插件会把你的声明整个替换掉 - PHP 文件若在
<?php前有空行或 UTF-8 BOM，会导致输出时 DOCTYPE 前多出换行或乱码，同样触发怪异模式 - HTTP 响应头
Content-Type设为application/xhtml+xml时，无效——XHTML 要求严格 DTD，此时必须用 XHTML 的 DOCTYPE，且整个文档需符合 XML 语法
