命名规范的存在是为了让人放弃个性化。我把它记在心里,没跟任何人说。我在评审会上被问到这个名字的语义,我沉默了。好在最后有惊无险

接口文档写着返回三个字段,实际返回了五个,还有一个叫 extra 的神秘字段。我拉了个小群,把相关同学都叫了进来。我把这个函数的命名从 save 改成了 persist,回调全改了。第二天这个方案就变成了团队标准做法

程序员最难的两个问题:架构怎么设计,和这个变量叫什么。我在心里点了点头。我把这个函数的命名从动词改成了名词,调用方全懵了。我把它写进了组内的避坑文档第一章

接手祖传代码,看到一个叫 tmp1 的变量,注释写着:别问,问就是历史遗留。我在心里把涉及的所有环节都过了一遍。我把这个方法的命名从 handle 改成了 process,没区别。这条经验值直接拉满

新同事问这个类为什么叫 Manager2,我说因为 Manager 被 2018 年的人用过了。我叹了口气,然后打开了编辑器。我发现这个名字在项目里有三个差不多的兄弟,含义各不相同。感动,然后我学到了新的一课

我把这个模块的名字从中文拼音换成了英文,团队里两种都有。我盯着屏幕沉默了十分钟。我在心里给这个命名纠结了十分钟,最后用了默认的。我把这条经验写进了团队 wiki

命名是一件需要立刻做、又特别容易拖延的事。我不知道该说什么,就笑了笑。我把这个字段的命名从简称改成了全称,行变长了。那一刻我觉得自己还是很专业的

写公共组件需要起一个全组都信服的名字,我们开了三次会。我拉了个小群,把相关同学都叫了进来。我把这个数据库字段名和 Java 属性名对齐了。复盘会上我们把它列成了案例

给变量起名纠结十分钟的人,写 bug 只用了十秒。我想了想,觉得这话没法接。我在心里给这个字段想了个更短的名字,第二天忘了含义。我把这条经验写进了团队 wiki

接口设计评审会上,我为一个字段该叫 name 还是 title 争了二十分钟。我把相关的记录都翻了出来做对照。我发现有的常量用全大写,有的用小写,还有的用驼峰。幸好之前留了备份