lang属性必须为ietf标准格式、须为直接子元素且唯一、标题层级必须连续，三者是可访问html的硬性准入门槛，缺一不可。
验收指标必须绑定到可执行的代码规则，而非抽象原则
可访问性不能靠“检查有没有 alt”这种模糊动作来验收。真正能进 CI 流程的指标，必须对应到具体、可静态扫描的 HTML 特征。比如 lang 属性是否符合 IETF 标准格式、<main></main> 是否为 的直接子元素且全局唯一、标题层级（<h1></h1>→<h2></h2>→<h3></h3>）是否连续——这三项不是建议项，是硬性准入门槛，缺一不可。
常见错误是把“已做无障碍测试”当成果，但没定义清楚“测什么、怎么判、谁来认”。例如：W3C 验证器不报 lang="zh" 错，但 NVDA 会 fallback 到英文朗读；HTMLHint 默认不启用 input-requires-label，不显式配置就等于没开。
-
lang必须写成zh-CN/zh-TW/zh-HK，后缀不可省略，且只能出现在标签上 -
<main></main>不能嵌套在<div> 或 <code><section></section>里，也不能重复出现（SSR 模板 include 多次是高频雷区） -
<h2></h2>后直接<h4></h4>是断裂，即使中间<h3></h3>被display: none隐藏，也必须从 DOM 中移除或加aria-hidden="true" -
"alt-require": true：强制所有<img>含alt，装饰图也得写alt="" -
"input-requires-label": true：拒绝未被<label></label>包裹、也未用for/id严格关联的<input>、<textarea></textarea>、<select></select> -
"frame-title-require": true：拦截缺失title属性的<iframe></iframe>（第三方地图、客服弹窗常漏） - JS 动态插入的
<img>没补alt - 模态框打开后焦点没 trap 在内部，用户按 Tab 会跳到背景页面
-
aria-live区域未声明，导致通知类内容（如表单成功提示）对屏幕阅读器不可见 - 自定义
role="tab"组件中aria-selected状态未同步更新
HTMLHint 是唯一能把标准翻译成构建时拦截的工具
HTMLHint 不是“可选插件”，它是把 WCAG 和 HTML5 语义规范翻译成机器可读规则的转换器。它不依赖运行时 DOM，只看源码结构，适合 pre-commit 和 CI 阶段卡点。
关键配置项必须显式开启，否则默认关闭：
注意：input-requires-label 不认 aria-label，只认原生语义——这是设计使然，不是缺陷。它要的是结构意图，不是运行时补救。
axe 负责捕获 HTMLHint 看不见的动态缺陷
HTMLHint 查源码，axe 查真实渲染后的 DOM。两者分工明确，不可替代。
axe 能发现的典型问题包括：
CI 中 axe 应设为“需人工确认”级别，因为部分结果依赖上下文判断（比如某张图是否真为纯装饰）。但它的报告必须存档，不能仅靠开发自查。
真正难的不是工具报错，而是判断“该不该修复”
当 frame-title-require 报错时，你得立刻判断那个 <iframe></iframe> 是嵌第三方地图还是客服系统——前者可加 title="地图位置"，后者若无法控制内嵌页，就得用 aria-label 或 aria-labelledby 替代，并在可访问性声明里注明限制。
同样，<main></main> 重复问题常来自组件库或布局模板拼接，修复点不在业务组件，而在框架层统一出口控制。这类问题不会在单个页面里暴露，只在多页面集成后浮现。
最易被忽略的是：所有验收指标都必须和上线流程强绑定。W3C 通过 ≠ 可访问，HTMLHint 通过 ≠ 可用，axe 无 error ≠ 用户能用。最终还得回归键盘+屏幕阅读器手动走查，尤其关注 tab 键路径、H 键跳转逻辑、错误提示是否可感知。
