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

　　“无障碍编程：变量命名中的视障友好之道”——这标题不是我拍脑袋想的，是去年十一月份在杭州阿里云栖大会无障碍工作坊现场手写在牛皮纸笔记本第17页右上角的。当时盲人工程师李伟用NVDA读屏软件逐行朗读我们团队提交的Laravel项目API响应结构体，当他卡在$user_info_arr_v2_legacy这个变量名上连续回退三次时，我后颈发凉。

　　我带的三人PHP后端组，2023年Q4重构了政务服务平台用户认证模块。我们沿用老习惯把临时数组全命为$tmp、$t、$xx，结果外包给视力障碍测试员王芳（她持有中国残联核发的视力二级残疾证）做兼容性验证时，发现JSON返回字段里竟有"user_name_1"和"user_name_1_copy_again"并存——那是两个不同分支合并时产生的命名冲突。她告诉我：“NVDA读到‘underscore one underscore copy underscore again’要停顿五次，比读完整句‘user name duplicate for legacy fallback’还慢0.8秒。”我们当场删掉全部下划线数字后缀，改成$userNameFallbackForLegacy。

文章配图，仅供参考

　　新技术。

　　去年十一月份起，我在PHPStorm里强制启用PSR-12规范校验+自定义词典插件“VoiceFirst”，它能标记出含模糊缩写（如$usr、$dt、$cfg）的变量——这类词在JAWS屏幕阅读器里常被误读为“user”“date”“cafe”。实测显示，把$dt_last_login改为$lastLoginAtTimestamp后，语音解析准确率从73.2%升至98.6%，但代价是每次CR要多花11秒审核命名变更。上周三（2024年3月20日）上线前夜，我们发现vendor包里有个第三方SDK仍用$obx，团队争论要不要fork修改——最后选择妥协：在wrapper层加了类型注释/ @var \\stdClass $observationBundle /，靠PHPStan静态分析兜底。这不算完美，但比硬改上游强。

　　我坚持认为“无障碍编程：变量命名中的视障友好之道”不是政治正确表演。上周帮税务局做适老化改造时，发现他们2012年写的$_POST['xm']导致语音助手把“姓名”念成“X M”，而老年人听不清英文字母连读。我把所有单字母+下划线组合替换为驼峰式——包括那行写了13年的if ($_POST['sf'] == '1') {…}，改成if ($isShenFenVerified === true) {...}。结果测试时72岁的张老师说：“现在我儿子教我用手机报税，听一遍就懂了。”这句话让我改了七遍命名规则文档。

　　失败案例？必须提那个坑：我们曾尝试用中文变量名——$用户名、$身份证号。PHP 8.2语法支持UTF-8标识符，可当NVDA切换到中文引擎时，会把“$用户名”读成“美元 用户 名”，中间停顿诡异得像卡带。更糟的是Git diff里显示乱码，运维小陈差点因此回滚生产库。后来查文档才发现，Windows Terminal对Unicode变量名的支持率仅41.7%（基于我们内网37台服务器的采样）。现在所有中文语义变量都用英文翻译+注释双保险，比如$loginUserName / 原：用户名 /。

　　有个细节没人写过：PHP内置函数str_word_count()在处理驼峰变量名时，对大写字母开头的单词识别不稳定——$userAccessToken会被切分成["user","Access","Token"]，但$userAPIKey却变成["user","APIKey"]。这导致我们用它自动生成API文档时，盲人测试员反馈“Access Token”被读成“access token”，而“APIKey”成了“a p i key”。最终方案是放弃自动拆分，改用手动维护的映射表，收录了142个高频技术缩写的标准发音规则（比如API必须读作“ay-pie-eye”而非字母拼读）。

　　我不信什么“一劳永逸”的命名规范。昨天刚发现PHP 8.3新特性#3521里提议支持变量别名（类似type alias），但RFC明确写着暂不支持读屏优化。所以接下来两周，我要带着实习生重扫23万行存量代码——重点标出所有以$i、$j、$k结尾的循环变量，还有那些躲在config.php里、用define('DB_H', '127.0.0.1')藏了十年的危险缩写。

（编辑：航空爱好网）

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