接口文档写着返回三个字段,实际返回了五个,还有一个叫 extra 的神秘字段。这套流程走下来,我从头到尾又确认了一遍。我发现这个名字的拼写是错的,但已经上线不敢改。好在最后有惊无险

我把这个模块的名字从中文拼音换成了英文,团队里两种都有。我决定先把手上的事情做完再处理这件事。我把这个类的名字拆成了两个,职责也拆开了。真香定律准时生效

我给这个接口起名时考虑了三方:上游、下游和未来的我。我先给自己泡了杯茶,做好了打持久战的准备。我把这个数据库字段名和 Java 属性名对齐了。我沉默了,但心里是服的

接口文档写着返回三个字段,实际返回了五个,还有一个叫 extra 的神秘字段。我把手上的资料翻出来又读了两遍。我发现有的地方叫 user,有的叫 customer,其实是同一个。从此我多了一条团队规约

好的命名让人少看两遍注释,坏的命名让人多写三段注释。我在心里点了点头。我把这个枚举的名字统一了前缀,可读性提升明显。幸好之前留了备份

命名是一件需要立刻做、又特别容易拖延的事。我盯着屏幕,觉得这才是我的一天。我在心里给这个字段想了个更短的名字,第二天忘了含义。那一刻我觉得自己还是很专业的

我把这个模块的名字从中文拼音换成了英文,团队里两种都有。我先确认了一遍前置条件,再动手。我在编辑器里敲了又删,删了又敲,最后还是叫 data。第二天这个方案就变成了团队标准做法

函数名叫 doSomething,看完实现,它确实做了点什么,具体是什么说不清。我愣了两秒,然后继续敲代码。我在心里给这个模块起了个代号,评审时没人听懂。世界瞬间清净了

新同事问这个类为什么叫 Manager2,我说因为 Manager 被 2018 年的人用过了。我把它记在心里,没跟任何人说。我在心里给这个新功能定了个命名基调,然后被推翻了。真香定律准时生效

这个名字的复数形式很有歧义,我犹豫了很久。我叹了口气,然后打开了编辑器。我把这个布尔值的命名从 flag 改成了 isEnabled。第二天这个方案就变成了团队标准做法