先说清楚:这不是我写的东西。它是 GitHub 上的开源项目(pa11y/pa11y,LGPL-3.0)。收录到这里的判断依据是 star 数、维护活跃度,以及对独立站运营是否真的用得上。
它能帮你做什么
- 一条命令出结果 —— 不用写测试代码,终端里给个 URL 就能拿到违规清单和对应的 HTML 片段。
- 能扫整站 —— 配套的 pa11y-ci 支持一次跑多个 URL,配合 sitemap 就是全站体检。
- 可设门槛卡发布 —— 设定允许的问题数上限,超了就让流水线失败,防止无障碍问题越积越多。
- 可配置标准 —— 支持 WCAG 2.1 A / AA / AAA 各级别,按你要达到的合规等级来跑。
怎么用
npm 全局安装后直接用:
npm install -g pa11y
# 扫一个页面
pa11y https://yoursite.com
# 作为项目依赖装(进 CI 用)
npm install pa11y --save-dev
默认按 WCAG 2.1 AA 标准检测。要扫整站请装 pa11y-ci,它支持读 sitemap 批量跑。
什么时候用它,什么时候用别的
要的是「能跑起来的成品工具」就用它;要嵌进自己的测试代码里、拿更细的结果,用 axe-core。两个可以并存,不冲突。


