接口文档写着返回三个字段,实际返回了五个,还有一个叫 extra 的神秘字段。我在心里把涉及的所有环节都过了一遍。我把这个组件的命名规范写进了团队文档,没人看。连茶水间都安静了

新同事问这个类为什么叫 Manager2,我说因为 Manager 被 2018 年的人用过了。我盯着屏幕,觉得这才是我的一天。我发现这个名字和系统保留字冲突,只能加后缀。连茶水间都安静了

接口文档写着返回三个字段,实际返回了五个,还有一个叫 extra 的神秘字段。我默默打开了编辑器,准备一步步验证。我在心里给这个类想了个更有业务含义的名字,太长了。我把这条经验写进了团队 wiki

写公共组件需要起一个全组都信服的名字,我们开了三次会。我把整条链路在心里复盘了一遍。我发现这个名字和系统保留字冲突,只能加后缀。我把这条经验写进了团队 wiki

我给这个函数起了个动词开头的名字,它其实什么也不做。我想了想自己这些年,好像确实如此。我把命名规范贴在了群里,然后就没人再理我了。复盘会上我们把它列成了案例

我在命名上纠结了十分钟,最后用了 ctx。这套流程走下来,我从头到尾又确认了一遍。我在心里给这个函数起了个名,叫 doSomething,非常准确。这条经验值直接拉满

命名规范里没写怎么处理这几种情况,于是大家都自由发挥。我想了想自己这些年,好像确实如此。我把这个布尔值的命名从 flag 改成了 isEnabled

这个名字的复数形式很有歧义,我犹豫了很久。我停了一下,然后继续手上的活。我在评审会上被问到这个名字的语义,我沉默了。好在最后有惊无险

这个名字在三个月后被我自己误解了。我叹了口气,然后打开了编辑器。我召集了两同事开了一个十五分钟的命名讨论会。这大概就是程序员的人生吧

命名是代码里唯一需要同时考虑机器和人的地方。我抬起头看了看周围,大家都一样。我把这个接口的名字从 get 改成了 fetch,因为要异步。世界瞬间清净了