无障碍编程：变量命名中的视障友好设计

文章配图，仅供参考

　　我盯着屏幕上的堆栈，机箱嗡嗡响得像在打快板。这字段是三个月前老张加的，当时他说要「优化视障用户体验」，我扫了眼代码，觉得不就是个布尔值吗？随手给起了个「is_blind_user」——现在看，这名字确实蠢得离谱。小王敲着桌子：「你们后端是不是觉得无障碍就是加个if判断？视障用户用屏幕阅读器读代码时，变量名得能直接翻译成语音提示啊！」

　　咖啡机坏了，我端着空杯子愣了半天。突然想起上周测试妹子提过，有个接口的返回字段名全用拼音缩写，她用读屏软件听的时候，直接报了串乱码。当时我还笑她：「谁让你用读屏软件测接口？」现在想想，这不就是我们自己埋的雷吗？

　　但说真的，变量名搞无障碍，我第一反应是「这他妈不是前端该管的事儿吗？」可小王甩给我几个案例：某大厂的API文档里，有个字段叫「dark_mode」，结果视障用户用读屏软件读出来是「黑暗模式」——可人家要的是「高对比度模式」啊！还有个更离谱的，字段名是「a11y_flag」，读屏软件直接念成「a one one y flag」，用户根本不知道这是无障碍开关。

　　我摸出手机翻聊天记录，发现老张在群里发过一篇论文链接，标题是《编程中的无障碍设计：从变量命名到代码可读性》。当时我瞄了眼摘要，觉得这帮学术派又在那儿扯淡——结果现在被现实打脸。小王指着屏幕：「你们后端现在连字段名都懒得起清楚，还怪我们前端改需求？看看这个『user_type』，是用户类型还是用户状态？是普通用户还是测试用户？读屏软件可分不清！」

　　外卖筷子掉在地上，我弯腰去捡，突然想起上周灰度发布时，有个接口的字段名从「is_vip」改成「vip_status」，结果测试妹子用读屏软件测的时候，直接报了「VIP状态」——而旧代码里是「是否是VIP」。这两者逻辑完全不一样，但读屏软件可不会告诉你区别。当时我们花了半天时间排查，最后发现是字段名变更没同步到文档里。

　　可话说回来，变量名搞无障碍真的有用吗？我原以为这不过是政治正确，结果小王给我看了个数据：某电商平台的后端重构后，把所有布尔值字段名从「is_xxx」改成「xxx_enabled」，视障用户的操作错误率降了30%。「因为读屏软件读『是否启用』比读『是否是』更清晰，」小王说，「你们后端总觉得变量名是给自己看的，可代码最后是要被机器和用户消费的——包括那些用辅助技术的用户。」

　　我盯着屏幕上的「user_info_blind_mode」，突然觉得这名字其实挺聪明——它没用「is_blind」，而是把「mode」加在后面，读屏软件会念成「用户信息盲模式」，比「是否是盲用户」更符合语境。可问题在于，这名字是我们后端自己定的，前端根本不知道它的语义边界。小王敲着键盘：「所以要么统一命名规范，要么加注释——但注释读屏软件可读不了，所以还是得靠名字本身。」

　　这时候运维老李凑过来：「你们聊啥呢？我工位上那台机器又蓝屏了。」我趁机转移话题：「老李，你说变量名搞无障碍是不是扯淡？」他挠挠头：「我原以为这是前端的事儿，结果上次改个定时任务，字段名从『run_at_night』改成『night_mode_enabled』，视障用户反馈说终于知道这任务是干嘛的了——以前读屏软件念『在夜间运行』，他们总以为是监控任务。」

　　但说到底，变量名搞无障碍最坑的还是「优胜劣汰」——那些没考虑无障碍的代码，迟早会被淘汰。我原以为这不过是道德层面的要求，结果发现它直接影响代码的可维护性。比如上周我们重构一个老系统，发现十年前的字段名全是「flag1」「flag2」，现在根本没人知道这些布尔值是干嘛的。而那些用了明确语义的字段，比如「payment_success_flag」，哪怕过了五年，新人看一眼也知道是支付成功的标志。

　　小王突然说：「其实最讽刺的是，你们后端天天喊『幂等』『限流』『缓存击穿』，这些概念对视障用户来说比变量名更难理解——可你们连变量名都懒得搞无障碍，还指望他们能用好你们的接口？」我张了张嘴，没说出话来。工位隔断上的便签卷了边，上面写着「接口超时优先查缓存」——可现在看来，连变量名这种小事都没做好，查缓存又有什么用？

　　最后我们定了个规矩：所有新字段名必须符合「语义明确+无障碍友好」的标准，布尔值统一用「xxx_enabled」或「xxx_active」的格式，枚举值必须带完整描述。老张在群里发了个点赞的表情包，我盯着屏幕上的「user_info_blind_mode_enabled」，突然觉得这名字也没那么丑了——至少读屏软件念出来，用户能知道这是干嘛的。

　　不过说真的，我现在最担心的是那些祖传代码——比如那个用「flag1」到「flag10」的表结构，改都没法改。小王说：「慢慢来吧，至少新代码别再留坑。」我点点头，心想：下次再遇到变量名的问题，我得先想想视障用户怎么读它——毕竟，代码不只是给机器跑的，也是给人用的。

（编辑：站长网）

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