Sublime Text 无法直接运行 WebHint，其插件已停更且不支持现代 ARIA 和动态属性检测；可行方案是通过 CLI 集成 + Build System 调用，并配合人工复核与 axe DevTools 验证。

Sublime Text 本身不检查无障碍（a11y）问题，WebHint 插件也**不能直接在 Sublime 中运行**——它是个 Node.js 工具，需命令行调用或集成到构建流程中；Sublime 里能装的只是它的“包装器”（如 sublime-webhint），但该插件早已停止维护，且不支持现代 HTML/ARIA 规范。

为什么 sublimewebhint 插件基本失效

截至 2026 年，sublime-webhint 插件仍依赖已废弃的旧版 webhint v6.x，无法识别：
• aria-modal="true" 等新 ARIA 属性
• `

` 元素的语义要求
• `` 缺失 label 的检测
• 暗色模式对比度校验（WCAG 2.1/2.2）
更关键的是：它不会扫描内联 <script></script> 或 Vue/JSX 模板块里的动态属性绑定（如 :aria-hidden="isMenuOpen"），而这恰恰是多数 a11y 漏洞所在。

真正可行的替代路径：用 CLI + Sublime 快捷键触发

把 webhint 当作外部工具，在 Sublime 里一键调用，比插件更可靠：

Sublime Text Build Linux版

Sublime Text Linux x86-64 deb 安装包。官方也提供 rpm、tar.xz 和软件源安装方式。

下载

• 全局安装最新版：npm install -g webhint@latest
• 在项目根目录写 .hintrc，启用 a11y 规则：

  {
    "extends": ["development"],
    "rules": {
      "axe": "error",
      "no-inline-style": "off",
      "valid-lang": "error"
    }
  }

• 配置 Sublime 的 Build System：
  • Tools → Build System → New Build System
  • 粘贴以下内容并保存为 WebHint.sublime-build：

  {
    "shell_cmd": "webhint --format=stylish $file_path",
    "file_regex": "^([^:]*):([0-9]+):([0-9]+):\s*(.*)$",
    "selector": "text.html,source.js,source.tsx"
  }

  
  • 按 Ctrl+B（Windows/Linux）或 Cmd+B（macOS）即可运行

常见误报与漏报必须人工复核

webhint 报 Element has insufficient color contrast 不代表真有问题——它只测静态 CSS，不考虑用户系统级暗色模式开关、浏览器强制配色或 CSS @media (prefers-contrast: high) 响应。同样，它无法判断：
• `` 内部用 SVG 替代文字时是否加了 aria-label
• `

真正要落地无障碍，得把 webhint 加进 pre-commit 钩子，再配合 axe DevTools 手动验证交互流程——Sublime 只是起点，不是闭环。