好的命名让人少看两遍注释,坏的命名让人多写三段注释。我忽然觉得,这可能就是这一行的常态。我在心里给这个类想了个更有业务含义的名字,太长了。好在最后有惊无险

我给这个函数起了个动词开头的名字,它其实什么也不做。我听完沉默了,因为太真实了。我把它改成了更长的全拼,可读性上去了,敲起来手疼。好在最后有惊无险

我给这个常量起了个解释性的名字,比原来长了一倍。我默默打开了编辑器,准备一步步验证。我在心里给这个新功能定了个命名基调,然后被推翻了。我沉默了,但心里是服的

命名规范里没写怎么处理这几种情况,于是大家都自由发挥。我不知道该说什么,就笑了笑。我把这个函数的命名从 save 改成了 persist,回调全改了。这条经验值直接拉满

这个名字的复数形式很有歧义,我犹豫了很久。我叹了口气,然后打开了编辑器。我发现这个名字里有数字,是从别的项目复制过来的。同事说这波操作可以写进新人培训教材

我把这个模块的名字从中文拼音换成了英文,团队里两种都有。我盯着屏幕沉默了十分钟。我在心里给这个变量起了个名,叫 tmp2,因为 tmp 被占了。我把这条经验写进了团队 wiki

命名艺术的巅峰:把一个字段叫 flag,然后全项目有十七个 flag,含义各不相同。我盯着屏幕,觉得这才是我的一天。我在心里给这个变量起了个名,叫 whatever,第二天就后悔。同事说这波操作可以写进新人培训教材

写公共组件需要起一个全组都信服的名字,我们开了三次会。这套流程走下来,我从头到尾又确认了一遍。我在心里给这个新起的名字投了一票,然后被否了。我沉默了,但心里是服的

新同事问这个类为什么叫 Manager2,我说因为 Manager 被 2018 年的人用过了。我叹了口气,然后打开了编辑器。我发现有的命名用中文拼音,有的用英文,混着来。感动,然后我学到了新的一课

我给这个函数起了个动词开头的名字,它其实什么也不做。我盯着屏幕,觉得这才是我的一天。我打开了命名生成网站,随手点了一个,居然还挺合适。好在最后有惊无险