Linux无障碍环境搭建：13年工程师实战指南

　　去年8月，残联那边要验收一个读屏适配的政务终端项目，我被拉去现场盯三天。机房空调坏了一台，吹出来那股子铁锈味混着烤面包机的焦糊气——隔壁工位老张非说那是他午餐三明治在散热口边放太久，没人理他。我盯着屏幕里 NVDA 切换到 Orca 的日志刷屏，右手无意识抠着键盘右下角掉漆那块，抠下来指甲缝里嵌着点灰白粉末。

文章配图，仅供参考

　　我原以为装个 at-spi2-core 和 speech-dispatcher 就完事。结果那个国产触控驱动一加载，GTK 应用的 AT-SPI 总线直接静音十七秒——不是报错，是彻底哑了，连 debug 日志都不吐一行。我蹲在终端前重新编译 dbus 时，运维小王端着杯枸杞茶路过，茶汤晃得特别匀，他顺手把杯子搁我显示器底座上，水渍在金属边沿慢慢洇开一圈浅黄印子。

　　优胜劣汰？对。但不是你想象的那样。不是谁调参更狠谁活下来，是哪个发行版的 accessibility.conf 里那行“enable-atk-bridge=true”写在第七行还是第九行，决定了 QT5 应用会不会把焦点事件喂给 Orca 而不是喂进 /dev/null。我见过两个团队做同样一件事：A 组把 Ubuntu 22.04 桌面版改源、降级 gnome-shell 到 42.9，硬扛住高对比度模式和屏幕放大器同时开启；B 组死磕 Debian 12 的 stable 源，最后在 login screen 卡死三次后，把所有 gtk3 应用强制跑在 X11 下——就因为 Wayland 下 at-spi2-registryd 那个 socket 文件权限永远比 systemd-logind 慢一百二十毫秒创建。这事我说不准，但那个毫秒数我敢打包票，抓了四次 tcpdump 看 socket 连接时序，差得一模一样。

　　老何你记得不？上季度末你发过一张 BI 报表，漏掉了某省医保结算系统的语音反馈字段，后来补数时发现他们用的是 TTS 引擎自定义的 audio ID 字段名，跟你们 ETL 里预设的“tts_id”对不上。我们当时的情况差不多：NVDA 默认用 IAccessible2，但某个国产 OCR 插件非要往 MSAA 接口塞数据，还把 role 属性写成中文“按钮”，不是英文 “button”。结果屏幕阅读器一碰到这个元素就卡顿二十三秒，不是崩溃，是卡——光标不动，CPU 占用停在 3%，ps aux 查进程还在跑，就是没响应。我试过 strace 它，它卡在 read() 等一个永远不来的 pipe 数据，管道那头，是那个插件在用户切换输入法时悄悄关掉了自己的 IPC server。这事儿我后来翻过三次代码，第三次才在它 release notes 第三页脚注里找到一句：“v1.2.3 改为按需启停 IPC，以降低内存占用。”

　　所以别跟我聊什么“标准化部署流程”。标准？标准是去年双十一前夜，测试组突然发现某政务 App 在 GNOME 侧边栏启用“显示辅助功能菜单”后，整个 dock 栏会随机闪退——不是每次，是每七次必崩一次，且只发生在搭载 AMD RX6600 显卡 + Mesa 23.2.1 驱动的机器上。我们查了三个月，最后定位到是 at-spi2-core 的 dbus 消息序列化里有个未初始化的 padding 字节，在特定 GPU 内存对齐下被显卡固件读成了非法 opcode……但这玩意儿根本没法进 CI，CI 用的是虚拟机，压根没有真实显卡。我就看着 QA 小李一边重装六次系统一边嚼着没吃完的辣条，油蹭到键盘 F12 键上，黑乎乎一块。

　　还有那个盲文点显器协议的事。不是所有厂商都认 BRLTTY 标准接口，有家浙江厂的设备必须通过自己写的 ttyS2 上层 daemon 做二次映射，而他们文档里写的“兼容 Linux 5.10+”——实际是指 kernel 5.10.76，不能高，不能低。我们测过 5.10.102，点显器能亮灯但字符全乱码；换成 5.10.76，连上就自动识别型号，输出也正常。但这个具体小版本号？我是在他们固件更新包解压后的 build.sh 里 grep 出来的，不是官网写的，官网写的是“5.10 及以上”，就这一句。我信了，信了两台服务器重启。

　　前两天在食堂碰见搞教育信息化的老周，他提了一嘴，说现在有些学校用 Chromebook 改的无障碍考试终端，背后其实跑的是 crouton 加载的 Ubuntu chroot，AT-SPI 环境靠 LD_PRELOAD 强打补丁进去……我听完没接话，扒拉饭盒里剩的青菜，叶子边缘有点蔫。反正我现在接到这类需求，第一反应不是装包，是先问客户：“你们用的什么牌子的盲文显示器？第几代？USB 口有没有串过 HUB？” 如果对方答得含糊，我立马掏出手机查天眼查——看他们工商变更记录里，去年有没有新增过“辅助器具研发”经营范围。有，就继续聊；没有，我直接回：“您找错人了，真不好意思。”

　　哦对，桌角那杯枸杞茶最后没喝完，凉透了，茶叶沉底结成一小坨褐色絮状物，像微型珊瑚。我上周把它倒进洗手池时，水流冲下去的瞬间，下水口咕噜响了一声，挺像 NVDA 切换朗读语速时那个卡顿音效。

　　我现在遇到 Linux 无障碍环境问题，第一反应不是搜 GitHub issue，是打开微信翻联系人——先找那个去年修过三台点显器驱动的售后小哥，再找上海交大无障碍实验室的王工，她上次发朋友圈说自家楼道感应灯坏了三天，因为维修师傅把光敏电阻焊反了。至于官方文档？我连 sudo 打开它都要犹豫三秒。

（编辑：站长网）

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