无障碍编程：变量命名如何无声包容视障开发者

　　器械区那股铁味混着前台的老歌飘过来，我靠在史密斯机旁边的凳子上，跟老陈说：“变量命名这事儿，跟咱们练深蹲似的——你以为蹲到底就行？去年八月份我改代码，发现视障开发者用屏幕阅读器读变量名，跟咱们用眼睛看完全是两码事。”老陈正用弹力带做肩外旋，手肘卡在90度，突然停住：“你意思是，变量名得像杠铃片一样，得有‘重量感’？”

　　我原以为这事儿简单，结果翻代码时被自己蠢到。去年接手一个健身社区的项目，有个视障开发者提了条PR，说“userList”和“userArray”在屏幕阅读器里读出来都是“用户列表”，分不清是数组还是链表。我当时还嘀咕：“这不都一样吗？”结果人家直接甩了段录屏——屏幕阅读器快速跳过变量名时，确实分不清“List”和“Array”的细微差别，就像咱们做高位下拉，肩胛骨没收紧，背阔肌根本没发力。

　　后来我查资料，发现屏幕阅读器对变量名的处理有套自己的逻辑。比如“btnSubmit”会读成“按钮提交”，“btn”是缩写，但“Submit”是完整单词，读起来有停顿感，视障开发者能通过节奏判断这是按钮。可要是写成“submitBtn”，读出来就变成“提交按钮”，节奏全乱了，跟咱们做硬拉时杠铃杆没对中，整个动作都变形。老陈放下弹力带，蹲下来捡地上的粉笔头：“所以变量名得像动作模式一样，得有‘可预测性’？”

　　地上有个用了一半的粉笔，是之前会员画训练计划留下的。我指了指它：“对，就像咱们教会员深蹲，得先让他学会髋关节后移，再慢慢加重量。变量名也得先保证‘可读性’，再考虑‘简洁性’。比如‘calculateTotalWeight’比‘calcTotWgt’好，前者屏幕阅读器读出来是‘计算总重量’，后者是‘计算总重量’（但缩写部分读得快，容易漏信息），跟咱们做卧推，握距太窄，胸肌没发力，全靠三头代偿。”

　　老陈突然笑了：“你记不记得上个月小王练废肩？他非说‘侧平举要甩起来’，结果肩峰撞击，养了两周。变量名要是‘甩’起来，屏幕阅读器也得‘撞’。”我点头：“对，变量名得‘稳’。比如‘getUserData’比‘fetchUserInfo’好，前者屏幕阅读器读出来是‘获取用户数据’，后者是‘获取用户信息’，‘数据’和‘信息’在业务里可能有区别，但屏幕阅读器读快了，根本分不清。就像咱们做引体向上，正手和反手，发力模式差老远，可要是不注意，新手根本感觉不出来。”

　　有人在拉伸区打哈欠，声音大得盖过前台的老歌。我压低声音：“最绝的是，视障开发者对变量名的‘长度’特别敏感。咱们写代码，‘i’‘j’当循环变量没问题，可屏幕阅读器读‘i’和‘j’时，发音太短，容易跳过。我之前有个循环，变量名是‘index’，屏幕阅读器读出来是‘索引’，比‘i’清楚多了。就像咱们做保加利亚分腿蹲，后腿垫高5厘米和10厘米，发力感完全不一样，变量名也得‘垫’到合适的高度。”

　　老陈站起来，拍了拍裤子上的粉笔灰：“所以你说‘优胜劣汰’，是指好的变量名能活下来，差的会被淘汰？”我摇头：“不是淘汰，是‘自然选择’。就像咱们训练，动作模式对了，肌肉自然长；变量名对了，屏幕阅读器读起来自然顺。去年我改那个健身社区的代码，把所有变量名按‘业务含义+数据类型’的规则重命名，比如‘userWeightKg’‘exerciseRepsCount’，视障开发者反馈说，读代码时终于不用猜‘这个变量是干啥的’了。就像咱们做深蹲，髋关节后移、膝盖对准脚尖、核心收紧，动作对了，重量自然能加上去。”

　　镜子上有一块手印，是之前会员做面拉时蹭的。我指了指它：“不过有个事儿我没完全想明白——有些变量名，比如‘temp’‘flag’，屏幕阅读器读出来是‘临时’‘标志’，可业务里这些词太抽象，视障开发者还是得靠上下文猜。可要是全写成‘temporaryVariable’‘isFlagSet’，又太长，读起来费劲。这就像咱们做硬拉，腰背挺直和微微反弓，哪个更安全？我原以为反弓能保护腰椎，结果看资料说，过度反弓反而增加压力，现在我也懵了。”

　　老陈笑了：“所以变量名这事儿，没绝对标准，得‘试错’。就像咱们教会员训练，得让他先做轻重量，感受发力，再慢慢加重量。变量名也得先保证‘可读’，再考虑‘简洁’。去年我改代码，把‘getUserById’改成‘fetchUserById’，结果视障开发者说，‘fetch’和‘get’在屏幕阅读器里读起来差不多，但‘fetch’更像‘抓取’，‘get’更像‘获取’，业务里‘获取’更常用。你看，连‘fetch’和‘get’这种常用词，都有区别。”

　　有人把杠铃片摔了一声巨响，震得器械区的铁架都晃。我捂了捂耳朵：“所以变量名得像动作模式一样，得‘可复用’。比如‘calculateTotal’可以复用到‘calculateTotalWeight’‘calculateTotalReps’，屏幕阅读器读出来是‘计算总重量’‘计算总次数’，业务逻辑清晰。就像咱们做杠铃卧推，标准握距和宽握距，发力模式不同，但都是‘卧推’，变量名也得有这种‘共性’。”

文章配图，仅供参考

（编辑：站长网）

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