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