写出别人一眼就懂的代码：逻辑清晰，规范至上

　　去年中考期间，我蹲在区教育局机房改脚本，空调坏了，整屋蒸笼味儿。王工叼着根没点的烟，在隔壁柜子翻固态硬盘，啪一声盖上盖子——那声脆响，比他说话还早零点三秒。

　　我原以为“逻辑清晰”是变量命名+缩进对齐，结果现场切题库生成模块时，发现前任留了段代码：用三个嵌套for循环筛出“近五年带‘实验’二字的物理题”，循环体里插了两行正则替换、一行time.sleep(0.01)，最后一行return的却是全局列表。谁写的？没人认领。但那个return前空了四格、后缩进两格的if块，我敢打包票是李姐改的——她写else必换行，else:永远顶格，这行没换，就是她半截改完去接了教务处电话，回来忘补。

文章配图，仅供参考

　　桌上那盒冷掉的麻婆豆腐，红油已经浮成一层膜。外卖小哥下午三点送来，说“考务组让放门口别敲门”，我就一直没动它。现在盒盖掀着，苍蝇停在豆瓣上，一动不动。

　　所谓“一眼就懂”，真不是让你读得快。是张工昨天调参失败，甩过来截图问我“为啥随机种子没生效”，我扫了一眼main.py第87行那个def gen_test_paper(seed=42, config={})，心里就发毛——config字典里埋着个'force_refresh': True，而seed参数在函数体里压根没被读取，直接被cfg.get('seed', 19)覆盖了。这不是错，这是暗河。你顺着表面逻辑走三步，就踩进另一个函数的default值里。张工后来自己扒出来，骂了句“操”，转头去重装conda环境。我说不出话。这种代码，不是写得慢，是别人根本不敢动。

　　优胜劣汰。真不是修辞。上周运维老陈说，他们删掉了五台旧服务器上的全部Python脚本——不迁移，不测试，全rm -rf。理由就一条：“看不懂哪个能跑，哪个会捅穿数据库。”他删的时候我在旁边泡茶，茶叶沉底，水还是浑的。他删完擦键盘，左手无名指指甲断了一小截，卡在Delete键缝隙里。我没提醒他。

　　机房的噪音是种恒定的嗡鸣，像变压器在低吼，中间夹着某台Dell塔式机风扇的间歇尖叫——咔…咔…咔…每三次停顿后变高半个音。你听得久了，会觉得所有报错信息都带着这个频率颤音。

　　有次我把一个解析Excel的脚本重构了，把原来三十行塞满pandas链式调用的process_data()，拆成load_raw()、filter_by_subject()、reindex_for_print()、add_answer_key()四层。文档写清输入/输出类型，每个函数不超过十二行。交上去第二天，小赵来问我：“老师，你写的reindex_for_print，是按题号顺序重排，还是按考点编码？”我说是按题号。他哦了一声，走了。十分钟后又回来：“你注释里写的‘适配打印模板’，但模板要求是按难度分区块，题号乱的。”我翻他给的模板PDF，第三页右下角铅笔写着“难-中-易分区，勿重排题序”。我盯着那行铅笔字看了十八秒。然后关了PyCharm，打开微信，撤回了五分钟前发给组长的“已完成交付”消息。

　　所以别跟我说什么“可维护性”。可维护的前提是：别人愿意翻开你的py文件。不是必须，是愿意。李姐上次写了个日志切割脚本，用os.listdir()硬扫目录，再用字符串截取判断日期，注释里写“兼容Win/Linux”。结果上线三天，Linux上因为路径斜杠多了一层，日志全塞进backup/2023/12/31/backup/2023/12/31……无限套娃。没人报bug，大家默默把log路径改成绝对路径，绕开它。那脚本还在git log里躺着，最后提交时间是去年冬至。冬至那天，下了雨。很小，但玻璃窗上全是斜的水痕，我看监控屏反光里自己的脸，是歪的。

　　我不信“规范至上”能救一切。但信它能筛人。信它能让不想懂的人，主动退出。张工昨天把config那段删了，重写了种子注入逻辑；小赵自己画了张打印模板分区草图贴工位旁；李姐换了IDE，现在写if必先打if冒号，等自动补全tab出来才继续。这些动作没进周报，也没人验收。但机房嗡鸣声里，多出了两台新机器的硬盘读写声——嗒、嗒、嗒，比老设备轻，也短促。像在呼吸。

　　我刚才试了三次Ctrl+S保存当前脚本，第一次弹出编码警告，第二次提示git暂存区冲突，第三次才静音成功。现在光标在最后一行末尾闪着，我删掉了四个空格，加了一个井字符，准备写行todo：// 这里需要测双字节题干截断。没写完。先吃饭吧，麻婆豆腐快结块了。

（编辑：站长网）

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