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

　　去年十二月，甲方在茶水间堵我，说“先做出来看看”。

文章配图，仅供参考

　　我原以为是那种带原型图的“看看”，结果他手机里存着淘宝首页截图，手指头戳着搜索框：“就这效果，三天内给我个能点的。”会议室投影嗡嗡响，像台快报废的冰箱，他坐在那儿转笔，笔帽掉了三次，没人捡。

　　销售把我推过去的，嘴上说“客户很爽快”，转头微信发来三张聊天截图：对方问“能包排名不”，销售回“看预算”，对方秒回“三千块够不够”。我盯着那句“三千块够不够”看了两分钟，没回。不是嫌少，是突然想起上个月那个要给宠物殡葬网站加“AI超度模块”的客户——最后连服务器都懒得续费，源码要走时还问我：“你删没删后台日志？”

　　项目启动那天，桌上那盘切好的哈密瓜没人动，边缘发干，泛着一层薄得看不见的白霜。甲方说“逻辑清晰，规范至上”，语气像念悼词。我没接话。他前脚说完，后脚就把UI稿发进群：粉色按钮换成莫兰迪灰，“改个颜色还要加钱？”——这句话我记特别准，因为他说完顺手把半块哈密瓜塞进嘴里，咔嚓一声。

　　第一版上线那天，电梯里撞见测试组老周，他胳膊底下夹着三份打印的《前端代码规范（2021修订版）》，纸角卷边，油墨味冲鼻子。我点头算打招呼，他压低声音：“你那个‘购物车数量实时同步’，接口每秒轮询八次？”我没答。他笑一下，按了负一层，门关前还补了句：“你们真敢让客户自己写需求文档啊？”

　　逻辑清晰？他们管“用户登录后自动跳转到上次浏览商品页”叫逻辑清晰。规范至上？我把 ESLint 配置文件拉给他看，他指着 rules 里那行 `'no-console': 'warn'` 问：“这个warn是警告还是取消？”我回微信说“是提示，不影响运行”，他隔了四十分钟回：“那关了吧，太占内存。”

　　回一条微信，我写了删、删了写、复制粘贴进企业微信又撤回——就为了把“console 不是内存占用主因”这句说得像人话。可最后只发了“已关”。对面秒回“好的辛苦”，附带一个抱拳表情。我盯着那个抱拳看了七秒，点开朋友圈，发现他十分钟前刚发过：凌晨三点配图咖啡杯+文字“创业狗不睡”。我点了个赞。不是认同，是怕他觉得我不共情。

　　拖了两个月，尾款没结。不是赖账，是“等运营跑出数据再付”。我说那把源码给您？他语音回：“必须给，不然怎么加功能。”我说加什么功能？他停顿两秒，说：“要能导出所有访客手机号，再加个弹窗，用户点‘关闭’也要记录一次。”我哦了一声。他补一句：“你写清楚注释，别整英文，我们老板要看。”

　　我写了三版注释：中文全拼音版、中英混杂版、纯英文版。最后交的是纯英文——因为提交前夜他助理打来电话，说老板刚在群里夸完某外包团队“专业”，截图里人家代码注释全是 `// TODO: handle edge case when user is offline` 这种。我听完挂电话，把拼音版注释全删了，一行没留。

　　真正亏在哪？不是三千块预算。是我在第十七次改“会员等级图标hover态”时，发现自己正在给一个连SSL证书都没买齐的站写TypeScript类型定义。更荒谬的是，我居然写了。还加了JSDoc。还手动校验了`@param`和实际入参是否一致。就因为甲方说“规范至上”。呵。

　　优胜劣汰？没错。但淘汰的从来不是代码质量差的团队，是还相信“客户说了算”的人。上个月另一个客户，要做个“能查全国充电桩实时空闲状态”的H5，预算五千，工期一周。我直接说“做不到”。他立刻拉黑我。第二天销售告诉我，那人找了三家外包，两家写了demo被拒收，第三家交货当天服务器崩了，源码里`fetch()`后面跟着`setTimeout(() => { location.reload() }, 3000)`，注释写着“防卡死”。我听完，把桌上那盘早该扔掉的哈密瓜端起来，倒进了洗手池。

　　客户原话我记住三句。一句是“先做出来看看”，一句是“改个颜色还要加钱？”，最绝的是验收会上他摸着笔记本说：“你们程序员，是不是非得用英文单词命名变量？”——我说是。他点头：“那就对了。我们领导懂英文。”

　　所以现在我接活前必干两件事：第一，看对方有没有Git账号；第二，让他现场手写一个for循环伪代码。不考语法，就看他写不写大括号。如果省略，合同里这条必须写死：“所有函数体起始大括号须独占一行，且与函数声明垂直对齐”。不是为代码整洁。是为下次他再说“逻辑清晰”，我能指着那行大括号说：“喏，这就是。”

（编辑：站长网）

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