这周刷掘金沸点,看到个帖子笑到一半突然心梗。坐旁边的老哥提了离职,走前最后一天把项目里所有注释全删了,美其名曰知识产权保护。接手的新人打开代码仓库直接傻眼,几千行逻辑配着拼音缩写变量名,活脱脱一本无字天书。有人评论说这操作比删库还狠——删库至少能 git 回滚,注释删干净了,那是真要从零开始做代码考古。
说真的,干这行十年,这种场面真见得不少。早上泡好枸杞菊花茶进公司,正琢磨今天摸鱼学点新框架,项目经理就在群里 @ 你,说小张离职前写的订单模块出了点问题,帮忙看一眼。你还淡定得很,程序员互相擦屁股是职业素养,跟护士换吊瓶一样正常。回完 ok 抿一口茶,点开仓库,往下翻五行,手直接一抖,茶杯哐当磕在桌沿。
不是烫的,是这代码太"刑"了。五千行代码,注释加起来两行半,变量名从 a1 排到 z26,if 嵌套深到能绕地球一圈。盯着屏幕看十分钟,脑子里只有一个念头:这小子离职前是不是故意的?
后来跟同行唠,发现每个人职业生涯里都有这么一个"小张"。有人接手过的项目,全篇注释就一句话——"这段代码别动,动会出事";有人碰过变量名全是拼音的,yonghuming、dingdanhao 排得整整齐齐,离职那天当事人还发朋友圈说江湖再见;更绝的是用繁体字命名变量的,美其名曰有文化底蕴,他走后全组人被迫对着屏幕认繁体字。

现在很多人说多大点事,扔给 AI 一键补注释不就完了。别太天真,AI 能补语法逻辑,补不了当年写代码时踩过的业务坑、绕开的兼容雷、跟产品扯皮后妥协的特殊逻辑。这些东西没写进注释,就是实打实的技术债务,利息高得离谱,哪天炸了全靠接盘的人背锅。
其实大家吐槽的从来不是"没写注释",是离职时的摆烂心态。好好写注释不是什么高尚奉献,是最基本的职业体面。之前认识个老开发,离职时交接文档写了 120 页,连哪个接口有历史遗留坑、凌晨两点会触发什么定时任务都标得明明白白。半年后系统出大问题,公司愿意花三倍日薪请他回去救场。
说到底,代码是写给人看的,顺便给机器跑。今天你留的烂摊子,明天说不定就落到自己头上。你们接手过最离谱的祖传代码是什么样的?来评论区比比惨。
|