html语法是否合规需通过w3c markup validation service验证，它暴露的是真实运行时风险而非写法问题：未闭合div导致dom错位、img缺alt触发a11y错误、meta charset位置错误引发乱码等，必须接入ci并覆盖动态路由页面。
HTML语法是否合规？W3C验证器不是摆设
不通过 W3C Markup Validation Service 的 HTML，基本没资格谈“工程化质量”。它暴露的不是“写法不够优雅”，而是真实运行时风险：未闭合的 <div> 可能导致后续 DOM 节点错位；<code><img> 缺 alt 属性会触发 axe 工具报 A11Y 错误；自闭合标签如 <br> 在 XHTML 模式下必须写成 <br>，但 HTML5 中 <br> 合法——混淆两者会在某些 SSR 场景中引发解析差异。
实操建议：
- 把 W3C 验证器接入 CI 流程，
curl -F "uploaded_file=@index.html" https://validator.w3.org/nu/可脚本化调用，失败则阻断构建 - 不要只验首页：动态路由生成的 HTML（如 Next.js 的
getStaticProps输出）也需抽样验证 - 注意验证器返回的 “Warning” 级别提示——比如
<section></section>缺heading，虽不中断渲染，但影响 Lighthouse 的结构化数据评分
语义化标签是否被真正使用？而非仅“看起来像”
很多团队在代码审查时看到 <header></header> 就打勾，但实际可能是：<header class="clearfix"><div class="logo">...</div></header>。这种写法让语义标签沦为样式容器，完全丢失了 role="banner" 的辅助技术含义，也破坏了搜索引擎对页面区块的识别逻辑。
实操建议：
- 禁止为语义标签添加纯布局类名（如
class="flex-center"），布局应由 CSS 控制，语义标签只表达意图 - 用 Chrome DevTools 的 Accessibility 面板检查
aria-role是否与标签语义一致：比如<button onclick="submit()>不能替换成<div role=" button></button>，前者原生支持空格/回车触发、焦点管理、键盘导航 -
<main></main>必须且只能出现一次，且不应被display: none或aria-hidden="true"隐藏——否则屏幕阅读器会跳过整个主内容区
meta 标签顺序是否严格按解析优先级排列？
<meta charset="utf-8"> 放在 <title></title> 后面，会导致 <title>你好</title> 被浏览器按 ISO-8859-1 解码成乱码，且无法回溯修复。这不是“偶尔出问题”，而是在所有未显式声明编码的旧版 WebView 中稳定复现。
实操建议：
-
<meta charset="utf-8">必须是内第一个标签，前面不允许有任何字符（包括 BOM、空格、注释） -
<meta name="viewport">应紧随其后，确保移动端缩放逻辑在 CSS 加载前生效 - 避免在
中插入异步 JS（如统计脚本），它们可能阻塞关键 meta 的解析；若必须加载，用defer或动态注入
lang 属性是否匹配实际语言内容？
设 但页面主体全是中文，会导致 VoiceOver 用英语发音引擎读中文，音调错乱；Google 搜索结果页可能将该页面归类为英文站，降低中文关键词排名；部分翻译插件（如 Google Translate）会拒绝自动翻译。
实操建议：
- 多语言站点必须按路由或区域动态设置
lang值，静态写死zh-CN不适用于国际化项目 - 避免使用模糊值如
lang="zh"：BCP 47 规范要求地区子标签（如zh-Hans简体、zh-Hant繁体）才能被现代辅助工具正确识别 - 服务端渲染（SSR）场景下，
lang必须由后端根据用户 Accept-Language 请求头或 locale 配置决定，前端 JS 修改无效
<nav></nav> 里混入了非链接内容，或者 <time></time> 的 datetime 值格式错误。这些不会报错，但会让自动化评估工具静默降权，最终在 SEO 和无障碍审计中集中爆发。
