无障碍编程：变量命名中的视障友好之道

去年1月，我主导的团队接了个医疗系统的安全重构项目——用户群体里15%是视障开发者。当时测试组反馈：他们用屏幕阅读器读代码时，变量名像“userData”“tempVal”这种缩写，屏幕阅读器会直接念成“用户数据”“临时瓦尔”，得反复回放才能确认含义。这事儿让我意识到，变量命名这事儿，真不只是给明眼人看的——它得“可听”。

　　我们做了个实测：让视障工程师用普通命名（如“isVld”表示“isValid”）和视障友好命名（如“isUserInputValid”）分别写200行代码。结果前者平均需要12分钟完成，后者仅需8分钟——屏幕阅读器读“isUserInputValid”时，会完整念出“is-user-input-valid”，而“isVld”会被念成“is-vee-ell-dee”，得靠上下文猜。更关键的是，后者在代码审查时，错误率下降了37%——因为变量名本身就在“说话”，减少了理解歧义。这数据直接推翻了我之前的认知：原来变量命名不是“怎么写都行”，而是能直接影响开发效率的“技术细节”。

文章配图，仅供参考

　　有个细节特别有意思：视障工程师更在意变量名的“发音逻辑”。比如“cnt”和“count”，屏幕阅读器读前者是“see-en-tee”，后者是“count”，后者明显更符合直觉。我们为此做了个“发音黑名单”——像“idx”“tmp”“ret”这种缩写，统统被替换成“index”“temporary”“returnValue”。有次测试时，一个视障工程师说：“以前读代码像听密码，现在像听故事。”这评价让我觉得，所谓“新技术”，未必是多复杂的算法，有时候改个变量名，就能让技术更有温度。

　　当然，这事儿也有局限——比如中文变量名，屏幕阅读器的处理效果就差很多。我们试过用拼音（如“yongHuShuJu”），但读起来像“永湖书局”，完全没意义；后来改用英文命名，又得考虑团队的非英语母语者。最后折中方案是：核心业务变量用英文全拼，辅助变量用“前缀+拼音缩写”（如“get_YHXX”表示“获取用户信息”），虽然不够完美，但至少在“可听性”和“可写性”之间找到了平衡点。

　　下一步我打算做个开源工具——能自动检测代码中的“不友好命名”，并给出替换建议。比如扫描到“isVld”，就提示“建议改为‘isValid’”。现在团队里已经有视障工程师主动参与测试，他们说：“要是所有项目都能用这种命名，我们写代码能少摔50%的坑。”这让我觉得，所谓“无障碍编程”，不是给少数人做的慈善，而是能让整个技术生态更高效的新技术——毕竟，代码的终极目标，是让人读懂，而不是让人猜。

（编辑：草根网）

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