lang属性必须为IETF标准格式、<main>须为<body>直接子元素且唯一、标题层级必须连续，三者是可访问HTML的硬性准入门槛，缺一不可。lang写错或缺失致屏幕阅读器误读，<main>嵌套或重复使AT跳过主内容，标题断裂导致用户“掉层”无法导航。
lang 属性必须严格匹配 IETF 标准，否则屏幕阅读器直接误读
只要 lang 值不是 zh-CN、zh-TW 或 zh-HK 这类带明确区域后缀的格式，NVDA 和 VoiceOver 就会 fallback 到英文发音——中文内容被逐字按英语音节朗读，语义完全断裂。
- 常见错误：
lang="zh"、lang="ch"、lang="{{ locale }}"未过滤非法值 -
<html lang="">必须在首屏 HTML 中静态写出，不能靠 JS 运行时 patch - 局部语言切换（如引文）要用嵌套
<p lang="en">，但根lang不可省略或错配 - SSR/静态站点生成时，模板引擎必须校验 locale 变量是否落入白名单，否则产出即不可用
必须是 的直接子元素且全局唯一
多个 <main> 或嵌套在 <div class="container"> 里，会导致 NVDA 直接跳过整个主内容区——用户按 M 键无响应，axe 工具报 critical 级别错误。
- 禁止在组件库中让子组件输出
<main>，布局层需统一收口 -
<main>不能包在<section>、<article>或任何其他块级容器内 - 服务端模板 include 多次、React/Vue 动态渲染未做去重，都可能意外产生重复
- 验证方式：打开 DevTools → Elements 面板搜索
<main，确认仅出现一次且父节点是<body>
标题层级断裂等于信息架构塌方，不是体验问题而是功能失效
遇到 <h2> 后紧跟 <h4>，屏幕阅读器用户按 H 键导航时会“掉层”——以为章节结束，实际内容还在继续。这不是逻辑瑕疵，是用户根本无法抵达后续信息。
- 视觉隐藏标题（
display: none或visibility: hidden）仍存在于 DOM，必须删节点或加aria-hidden="true" - 第三方组件默认用
<h2>作卡片标题，嵌套在<h2>主区下，立刻造成 H2→H2 断层 - 每个
<section>必须以<h2>或更高级别开头；若需重置层级，必须显式提供标题，不能留空 - JS 动态插入标题前，必须校验当前最大层级，否则
document.createElement('h3')可能直接跳到 h5
用原生标签比写 ARIA 更关键，div 模拟 button 是典型交付陷阱
看到 <div role="button" tabindex="0"> 就该立即叫停——它缺键盘事件监听、缺禁用状态同步、缺 focus 样式、缺 aria-pressed，漏一项，键盘用户就卡死。
立即学习“前端免费学习笔记（深入）”；
-
<button>自带聚焦、回车/空格触发、role="button"、type="button"默认防提交，无需额外补 - 所有交互元素必须能被 Tab 访问：检查是否误设
tabindex="-1"，或 CSS 把outline彻底抹掉 -
<nav>必须配aria-label，且值要具体（如"主导航"），不能写"Navigation"或留空 -
<label>关联只认 DOM 结构：要么for="id"+id="id"严格一致，要么嵌套<label><input></label>，CSS 对齐无效
工程化交付不是堆 ARIA 属性，而是从模板源头控制语义结构、语言声明和标题流——这些点一旦出错，后续所有测试、自动化扫描、人工验收都会反复失败。真正难的不是写代码，是让每个构建环节都守住这三条线：lang 格式、main 唯一性、标题连续性。
