无障碍编程:变量命名如何无声包容视障开发者
|
老张把切割机往墙根一推,火花子溅到水泥袋上,他冲我喊:"这变量名你到底咋定的?视障那哥们儿昨天又卡壳了。"我叼着烟凑过去,屏幕上是满屏的`user_info_list`、`tmp_data_array`,切割机的嗡嗡声在楼道里回响,震得我耳朵发麻——这破机器该换轴承了,上个月就该换,结果材料商说缺货,拖到现在。 "你当是给明眼人写代码呢?"我吐了口烟,"变量名得像盲道似的,得有触感。比如`user_list`和`user_array`,他摸屏幕读出来,能知道这是列表还是数组?可要是全写成`user_data`,他连数据结构都分不清,跟走迷宫似的。"老张蹲下来扒拉地上那卷被踩扁的电线:"那咋整?总不能每个变量都加注释吧?" 我原以为这事儿简单,结果上周返工时差点没把我气死。那视障哥们儿接手的项目,原代码里全是`temp1`、`temp2`,他摸屏幕读出来全是"tmp1""tmp2",跟听密码似的。后来我让他把临时变量全改成`temp_user_id`、`temp_order_num`,他摸两遍就说:"哦,这是用户ID的临时变量,那是订单号的临时变量。"效率直接翻了一倍——可你猜怎么着?那帮明眼人程序员反而骂我"多此一举",说"变量名起那么长,敲键盘累不累?"
文章配图,仅供参考 门口那堆沙子被雨浇出个坑,水洼里映着对面楼的玻璃幕墙。我想起上个月验收时,业主非说贴砖收口没对齐,其实就歪了半毫米,可他拿尺子比着量,非让返工。现在倒好,代码里变量名歪一毫米,视障开发者就得花十分钟去摸清楚——这哪是代码问题?这是人的问题。"优胜劣汰懂不懂?"我踩灭烟头,"变量名起得好的,视障开发者用着顺,代码迭代就快;起得烂的,他卡半天,项目进度就拖。时间久了,谁还敢用烂变量名?"老张抬头:"那要是视障开发者自己起变量名呢?他咋知道明眼人能不能看懂?" 我乐了:"所以他得学'通用变量名规范'啊。就像咱们走顶布线,明眼人看图纸能懂,视障开发者摸线管走向也能懂——变量名也得有这种'通用性'。比如`user_name`,他摸出来是'用户姓名',明眼人看也是'用户姓名',这就通了;可要是他写成`uname`,明眼人可能懂,但他自己摸两遍都未必知道这是啥。" 水泥袋上的灰被风卷起来,落在老张的工装裤上。他突然说:"那要是遇到那种'既要又要'的变量名呢?比如`user_info_list_array`,这他妈是列表还是数组?"我摇头:"这就是烂变量名,甭管视障不视障,都得骂。好的变量名得像梯子——少一根横撑都上不去。比如`user_list`,他摸出来知道是列表;`user_array`,知道是数组;`user_info`,知道是用户信息对象。简单、直接、没歧义。" 上次返工是因为变量名歧义。原代码里有个`data`,视障开发者摸出来以为是"数据",结果跑起来发现是"配置文件"——他当场摔键盘,说:"这他妈是数据还是配置?你让我摸屏幕能摸出区别?"后来我改成`config_data`,他摸两遍就说:"哦,这是配置数据。"问题解决——可那帮明眼人程序员还在群里吵:"'config_data'太长了,不如'cfg_data'!"我直接回:"你让视障开发者摸'cfg_data',他能摸出是'配置数据'还是'错误代码'?"群里瞬间安静。 谁在阳台上打电话?声音挺大,但听不清说啥。老张站起来拍了拍裤子:"那要是遇到那种'历史遗留变量名'呢?比如十年前的代码,全是`a`、`b`、`c`,咋整?"我叹气:"这种就得慢慢改。先挑核心模块改,改一个变量名,就让视障开发者测一次,测通了再改下一个。就像咱们装修,先改水电,再改墙面,最后改地板——不能一口气全拆了,那得乱套。" 我原以为视障开发者用代码得靠"特殊工具",结果发现他们靠的是"变量名的触感"。就像盲道上的凸起,变量名里的"结构词"(list、array、dict)就是凸起,他摸到这些词,就知道数据长啥样;摸不到,就得猜。你猜错了,代码就报错;代码报错,项目就延期;项目延期,老板就骂人——最后倒霉的还是咱们这些写代码的。 "所以啊,"我指着屏幕,"变量名得像盲文,得有'触感'。视障开发者摸屏幕读代码,跟咱们看屏幕读代码,本质一样——都得靠变量名传递信息。信息传准了,代码就好维护;传歪了,就得返工。"老张点头:"那以后写代码,是不是得先想想'视障开发者能不能摸懂'?" 水泥袋上的灰又厚了一层,风一吹,像下小雪。我想起自己家那处没修的卫生间,墙皮掉了半年,一直没空补——就像那些烂变量名,明知道有问题,就是懒得改。可要是视障开发者用你的代码,你敢留烂变量名吗?他摸不出来,你就得花十倍时间解释;解释不清,项目就得黄。优胜劣汰,就是这么残酷。 "所以啊,"我最后说,"变量名起得好,视障开发者用着顺,明眼人看着也舒服;起得烂,两边都得骂。这事儿没有中间地带——要么优,要么汰。"老张蹲下来收拾工具:"那从今天起,我写变量名都加结构词。"我笑:"对,就照着盲道修——凸起够多,路才好走。" 切割机又响起来,火花子溅得更远了。我摸了摸口袋里的烟,发现只剩半根——得让材料商再送一包了。这变量名的事儿,就跟送烟似的——你得知道对方要啥,才能送对味儿。送错了,人家不领情;送对了,事儿就顺了。 (编辑:云计算网_韶关站长网) 【声明】本站内容均来自网络,其相关言论仅代表作者个人观点,不代表本站立场。若无意侵犯到您的权利,请及时与联系站长删除相关内容! |




浙公网安备 33038102330456号