我给这个接口起名时考虑了三方:上游、下游和未来的我。我重新看了一遍手上的计划,把风险项标了出来。我发现有的字段用下划线,有的用驼峰,还有的用连字符。真香定律准时生效

接手祖传代码,看到一个叫 tmp1 的变量,注释写着:别问,问就是历史遗留。我默默打开了编辑器,准备一步步验证。我把这个接口的返回结构命名统一了,前端不用再猜。第二天这个方案就变成了团队标准做法

我给这个函数起了个动词开头的名字,它其实什么也不做。我抬起头看了看周围,大家都一样。我最后把它命名为 handler,虽然它并不处理任何东西。办公室安静得能听见键盘声

变量命名二选一:data 和 data2,顶级架构师的纠结就到这了。我把这个枚举的名字统一了前缀,可读性提升明显。我把它写进了组内的避坑文档第一章

命名最怕的是把未来的实现细节写进名字里。我停了一下,然后继续手上的活。我把这个常量的命名规范统一了一遍,从三种变成一种。从此我多了一条团队规约

这个名字的复数形式很有歧义,我犹豫了很久。我叹了口气,然后打开了编辑器。我在编辑器里敲了又删,删了又敲,最后还是叫 data。我把它写进了组内的避坑文档第一章

接口设计评审会上,我为一个字段该叫 name 还是 title 争了二十分钟。我决定先把手上的事情做完再处理这件事。我把这个方法的命名从 handle 改成了 process,没区别。办公室安静得能听见键盘声

接手祖传代码,看到一个叫 tmp1 的变量,注释写着:别问,问就是历史遗留。我决定先把手上的事情做完再处理这件事。我发现这个名字的拼写是错的,但已经上线不敢改。真香定律准时生效

这个名字在三个月后被我自己误解了。我不知道该说什么,就笑了笑。我发现这个名字和隔壁模块的几乎一样,只差一个字母。复盘会上我们把它列成了案例

命名艺术的巅峰:把一个字段叫 flag,然后全项目有十七个 flag,含义各不相同。我盯着屏幕,觉得这才是我的一天。我把这个模块的命名缩写展开了一遍,比原来还长。复盘会上我们把它列成了案例