必须用https://validator.w3.org/nu/，因它是唯一支持HTML5全量语法的官方校验器；粘贴需含完整DOCTYPE和根结构，否则报missing DOCTYPE；Element X not allowed as child of Y等错误须按HTML5内容模型修正。
必须用 https://validator.w3.org/nu/，其他工具只能辅助，不能替代它。 旧版 W3C 验证器（https://validator.w3.org/）不支持 HTML5 新元素（如 <dialog>、<slot>），会把合法代码标成错误；而 Nu HTML Checker 是当前唯一能准确解析完整 HTML5 语法的官方校验器。
为什么粘贴代码后报 missing DOCTYPE？
这是最常卡住的第一步。Nu 校验器严格要求输入内容是完整文档：必须包含 <!DOCTYPE html> + <html> 根标签 + <head> 和 <body>（哪怕为空）。只粘一段 <div>xxx</div> 就会直接报错，不是工具问题，是它按标准解析器行为模拟的——真实浏览器也只对完整文档做语义化解析。
- 解决办法：复制整个
index.html文件内容，不要截取片段 - 如果只是验证局部结构（比如组件模板），先套一层
<!DOCTYPE html><html><body>...</body></html>再粘贴 - 别信编辑器右键“格式化”或“美化”，那只是缩进调整，不保证语义合法
验证结果里出现 Element X is not allowed as child of element Y 怎么修？
这是 HTML5 内容模型限制，不是拼写或闭合问题。例如：<p><div>xxx</div></p> 在任何浏览器里都“能显示”，但 <div> 不属于 <p> 的合法子元素，Nu 会报错，且浏览器 DOM 解析时会自动把 <div> 提到 <p> 外面——你写的和最终渲染的 DOM 已不一致。
- 查 MDN 上每个元素的 Permitted content 栏位（比如 MDN <p> 文档）
- 常见陷阱：
<h1>~<h6>不能嵌套其他标题；<ul>只能含<li>；<table>必须有<tbody>或<thead>等明确包裹 - 别依赖 Auto Close Tag 插件——它能补
</div>，但不会拦你在<p>里放<div>
本地开发时怎么快速验证，又不想每次上传？
命令行工具 htmlhint 是唯一靠谱的本地方案，但默认配置几乎不报错，等于没装。真正起效需三步到位：
立即学习“前端免费学习笔记（深入）”；
- 全局安装最新版：
npm install -g htmlhint（旧版 v0.12.x 不识别现代规则） - 在项目根目录建
.htmlhintrc（注意前面的点），内容至少含："tagname-lowercase": true,<br>"attr-lowercase": true,<br>"attr-value-double-quotes": true
- 运行：
htmlhint "**/*.html"（必须加**/才扫描子目录）
如果 htmlhint index.html 没输出，先跑 htmlhint --version 看是否真装上了——多数失败源于 npm bin 路径没进系统 PATH。
浏览器 Elements 面板里灰色斜体的标签、突兀缩进断裂、右键 Edit as HTML 后结构重排……这些全是浏览器已悄悄修正 DOM 的铁证。你看到的“正常”，恰恰说明源码有问题。W3C 验证器报的每一行错误，背后都对应真实渲染风险，不是为了“达标”，而是防止某天换浏览器或升级后页面突然错乱。
