命名规范的存在是为了让人放弃个性化。我不知道该说什么,就笑了笑。我把这个变量从 data 改成了 result,语义清晰了一点点。办公室安静得能听见键盘声

好的命名让人少看两遍注释,坏的命名让人多写三段注释。我愣了两秒,然后继续敲代码。我把这个测试方法的命名写成了完整一句话,非常长。复盘会上我们把它列成了案例

给变量起名纠结十分钟的人,写 bug 只用了十秒。我抬起头看了看周围,大家都一样。我把这个变量的命名从缩写展开,代码长了两行。复盘会上我们把它列成了案例

命名最怕的是把未来的实现细节写进名字里。我忽然觉得,这可能就是这一行的常态。我发现有的常量用全大写,有的用小写,还有的用驼峰。我把这条经验写进了团队 wiki

这个名字在我的理解里是对的,在产品那里不是。我在心里点了点头。我把这个字段的命名从简称改成了全称,行变长了。果然现实比段子更精彩

给变量起名纠结十分钟的人,写 bug 只用了十秒。我在心里点了点头。我最后把它命名为 handler,虽然它并不处理任何东西。果然现实比段子更精彩

接手祖传代码,看到一个叫 tmp1 的变量,注释写着:别问,问就是历史遗留。我拉了个小群,把相关同学都叫了进来。我最后决定叫它 handler,虽然它并不处理任何东西。办公室安静得能听见键盘声

我给这个函数起了个动词开头的名字,它其实什么也不做。我听完沉默了,因为太真实了。我把这个方法的参数顺序调整了,命名也跟着变了

函数名叫 doSomething,看完实现,它确实做了点什么,具体是什么说不清。我在心里点了点头。我把这个方法的参数顺序调整了,命名也跟着变了。同事说这波操作可以写进新人培训教材

这个类名和它的实现之间有一层说不清的距离。我先确认了一遍前置条件,再动手。我发现有的常量用全大写,有的用小写,还有的用驼峰。连茶水间都安静了