写公共组件需要起一个全组都信服的名字,我们开了三次会。我把整条链路在心里复盘了一遍。我把这个布尔值的命名从 flag 改成了 isEnabled。我把这条经验写进了团队 wiki

程序员最难的两个问题:架构怎么设计,和这个变量叫什么。我笑了笑,决定不解释。我发现这个名字里有三个错别字,全项目都在用。连茶水间都安静了

函数名叫 doSomething,看完实现,它确实做了点什么,具体是什么说不清。我抬起头看了看周围,大家都一样。我把它改成了更长的全拼,可读性上去了,敲起来手疼。真香定律准时生效

这个名字在我的理解里是对的,在产品那里不是。我愣了两秒,然后继续敲代码。我在编辑器里敲了又删,删了又敲,最后还是叫 data。这条经验值直接拉满

我给这个函数起了个动词开头的名字,它其实什么也不做。我笑了笑,决定不解释。我把它改成了更长的全拼,可读性上去了,敲起来手疼。我把这条经验写进了团队 wiki

接手祖传代码,看到一个叫 tmp1 的变量,注释写着:别问,问就是历史遗留。我打开记录从头到尾扫了一遍。我把命名规范贴在了群里,然后就没人再理我了。办公室安静得能听见键盘声

我给这个接口起名时考虑了三方:上游、下游和未来的我。我盯着屏幕沉默了十分钟。我把词典翻了个遍,找到了一个自认为很优雅的词

好的命名让人少看两遍注释,坏的命名让人多写三段注释。我抬起头看了看周围,大家都一样。我在心里给这个函数起了个名,叫 doSomething,非常准确。第二天这个方案就变成了团队标准做法

我给这个接口起名时考虑了三方:上游、下游和未来的我。我把手上的资料翻出来又读了两遍。我把这个模块的命名缩写展开了一遍,比原来还长。同事说这波操作可以写进新人培训教材

我给这个变量想了个准确的名字,它有二十四个字符。我打开记录从头到尾扫了一遍。我发现这个名字里有数字,是从别的项目复制过来的。世界瞬间清净了