Linux无障碍环境搭建：零配置到语音导航全指南

　　两个月前，产品在站会上说“下周无障碍要上线”，我盯着他身后那块没擦干净的白板，上面还留着上个月画的React生命周期图，粉笔灰糊成一片。没人提Linux——直到周四下午三点十七分，测试同学发来截图：Orca读屏器在GNOME里把按钮文本念成“button slash button”，而我们的H5页面正跑在Electron壳里，用的是Chromium 115内核，不认AT-SPI总线。我敲完sudo apt install orca回车那秒，工位右边那位老哥端着保温杯站了快两分钟，没坐回去，也没说话。

　　先扔结论：所谓“零配置”是骗自己，“语音导航全指南”是骗用户。它连最基本的GTK3控件role都没对齐，更别说我们那种用div[role="button"]硬顶出来的自定义组件——Orca压根不进你的focusable list，只会跳过、静音、或者把整个section念成“unknown”。你改CSS focus outline？没用。你加aria-live="polite"？它根本不订阅。你在控制台里打document.activeElement能看到焦点，但Orca的语音流早就在后台断了三次，日志里只有atspi-registryd: connection reset by peer，和上次后端改gRPC proto字段时一模一样。

　　亲历现场：周三下午四点，我切到一台标着“Debian 12.5 + GNOME 43”的测试机，键盘上空格键掉了——就那个常按的——我用食指关节代替按了七分钟，才把orca -s启起来。启动后第一句语音是“Welcome to Orca”，第二句是“application has no accessible name”，第三句直接哑火。不是卡顿，是声卡驱动里snd_hda_intel模块加载顺序错了一位，导致PulseAudio把Speech Dispatcher的stream当成了sink monitor，mute掉了。这玩意儿查不到报错，只在journalctl -u speech-dispatcher | grep -i 'failed'里埋了一行：“Failed to connect to PulseAudio server (No such file or directory)”。而你的页面还在console里刷着React Strict Mode双渲染的warning，像在陪葬。

文章配图，仅供参考

　　有人在背后走过碰了椅子，声音不大，但我听见了。因为那一刻Orca正在试图读取一个用display: none临时藏起又用transform: translateY(-999px)模拟隐藏的菜单项——它念出来了：“menu item hidden off screen hidden off screen hidden off screen”。不是bug，是规范。ARIA Authoring Practices 1.2第6.17条写得明明白白：不能靠视觉隐藏欺骗AT。但我们代码里有六处这种写法，全在header.jsx里，commit hash是a8f3c1b（上周二下午五点十三分，产品经理说“先这么发，语音功能等V2补”）。现在补不了。Orca的事件监听器挂载时机比React componentDidMount早200ms，等你的useEffect(() => { initA11y() }, [])执行完，AT树早就冻住了。

　　不解释什么叫“无障碍树”——你肯定见过DevTools里那个Accessibility面板卡死在“Loading…”的状态，旁边时间戳显示2024-03-17 16:44:02。也不解释为什么Chrome DevTools里的“Simulate Assistive Technology”永远只模拟JAWS。我说的是实际发生的事：我昨天用orca --debug重放操作路径，发现它第一次尝试读取页面标题时，触发了我们页面里那段window.addEventListener('load', () => { document.title = document.title + ' | Accessible'; })——于是Orca刚读出“Dashboard”，title就变成“Dashboard | Accessible”，它立刻中断重读，结果读成“Dashboard bar Accessible”，然后缓存这个发音，后续所有tab页都带bar音。不是逻辑问题，是语音合成引擎在听觉缓冲区做token切分时撞上了DOM mutation。

　　会议室白板角落还粘着半截蓝色便利贴，上面是设计稿标注：“图标按钮须带tooltip”。他们没标tooltip的触发机制，也没标键盘hover是否需要focusable="true"。结果我们写了title属性，但Orca默认关掉title朗读——得手动进Orca设置里开Enable tooltip reading，再重启服务。重启之后呢？它又忘了你之前设的语音速率，调回默认120WPM，而我们的听力障碍测试员习惯180。没人告诉文档写这个。指南里只有一句：“运行orca即可”。运行完呢？首屏转圈、按钮点了没反应、控制台一片红。

　　显示器是竖着的，我低头看终端时脖子酸。外卖到了没人去拿，塑料袋在门口堆成小山。我打开构建日志搜“a11y”，看到Webpack插件eslint-plugin-jsx-a11y早在去年十月就因为ESLint v8升级失效了，但CI没报警——因为我们把exit code 1写进了.eslintignore下面一行注释里：“// temp disable a11y lint until orca compat”。注释日期是2023-10-11，提交人叫“product_qa_support”，邮箱后缀是公司旧域名。

　　下一步：我把Orca config目录打包推到私有Nexus，强制每个前端构建镜像拉取预配好的orca.conf，关掉自动检测，硬编码speech-dispatcher socket路径。不是解法，是止血。真正要动的是Electron壳的WebContents初始化参数，加--force-renderer-accessibility，再hook掉Chromium原生AT桥接失败时的fallback逻辑。不过这得等C++同事腾出手——他今早刚修完那个把SVG 当纯文本插入innerHTML导致内存泄漏的bug，commit message里写着“fix svg title XSS”。

（编辑：站长网）

【声明】本站内容均来自网络，其相关言论仅代表作者个人观点，不代表本站立场。若无意侵犯到您的权利，请及时与联系站长删除相关内容!