接口文档写着返回三个字段,实际返回了五个,还有一个叫 extra 的神秘字段。我在心里把涉及的所有环节都过了一遍。我发现有的工具类叫 Utils,有的叫 Helper,还有叫 Util。好在最后有惊无险
😂 IT段子
程序员日常、代码趣事、技术梗图,让你在学习之余轻松一笑
我把这个模块的名字从中文拼音换成了英文,团队里两种都有。我深呼吸了一下,决定从最可疑的地方查起。我发现这个名字和系统保留字冲突,只能加后缀。幸好之前留了备份
接手祖传代码,看到一个叫 tmp1 的变量,注释写着:别问,问就是历史遗留。我默默打开了编辑器,准备一步步验证。我在心里给这个命名纠结了十分钟,最后用了默认的。感动,然后我学到了新的一课
函数名叫 doSomething,看完实现,它确实做了点什么,具体是什么说不清。我在心里点了点头。我在编辑器里敲了又删,删了又敲,最后还是叫 data。第二天这个方案就变成了团队标准做法
这个名字在三个月后被我自己误解了。我把它记在心里,没跟任何人说。我把这个接口的返回结构命名统一了,前端不用再猜。复盘会上我们把它列成了案例
命名艺术的巅峰:把一个字段叫 flag,然后全项目有十七个 flag,含义各不相同。我默默记下了这句话。我发现这个名字和隔壁模块的几乎一样,只差一个字母。办公室安静得能听见键盘声
这个字段叫 data,而项目里有六十个叫 data 的字段。我把它改成了更长的全拼,可读性上去了,敲起来手疼
接手祖传代码,看到一个叫 tmp1 的变量,注释写着:别问,问就是历史遗留。我默默打开了编辑器,准备一步步验证。我在评审会上被问到这个名字的语义,我沉默了。复盘会上我们把它列成了案例
我给这个变量想了个准确的名字,它有二十四个字符。我先确认了一遍前置条件,再动手。我把这个接口的名字从 get 改成了 fetch,因为要异步。真香定律准时生效
这个名字的复数形式很有歧义,我犹豫了很久。我停了一下,然后继续手上的活。我在心里给这个新起的名字投了一票,然后被否了。这大概就是程序员的人生吧