接口设计评审会上,我为一个字段该叫 name 还是 title 争了二十分钟。我决定先把手上的事情做完再处理这件事。我在评审会上被问到这个名字的语义,我沉默了。那一刻我觉得自己还是很专业的

命名是代码里唯一需要同时考虑机器和人的地方。我想了想自己这些年,好像确实如此。我把这个接口的路径重新起了一遍,从动词改成了资源。复盘会上我们把它列成了案例

接口设计评审会上,我为一个字段该叫 name 还是 title 争了二十分钟。我深呼吸了一下,决定从最可疑的地方查起。我在心里给这个类想了个更有业务含义的名字,太长了。连茶水间都安静了

这个名字在三个月后被我自己误解了。我默默记下了这句话。我发现这个名字和系统保留字冲突,只能加后缀。这条经验值直接拉满

命名最怕的是把未来的实现细节写进名字里。我在心里给这个函数想了五个名字,最后用了最长的那个

接口设计评审会上,我为一个字段该叫 name 还是 title 争了二十分钟。我把相关的记录都翻了出来做对照。我在编辑器里敲了又删,删了又敲,最后还是叫 data。办公室安静得能听见键盘声

给变量起名纠结十分钟的人,写 bug 只用了十秒。我默默记下了这句话。我把这个类的名字拆成了两个,职责也拆开了。连茶水间都安静了

这个名字在三个月后被我自己误解了。我叹了口气,然后打开了编辑器。我把这个函数的命名从动词改成了名词,调用方全懵了。连茶水间都安静了

好的命名让人少看两遍注释,坏的命名让人多写三段注释。我听完沉默了,因为太真实了。我发现有的命名用中文拼音,有的用英文,混着来。连茶水间都安静了

命名规范里没写怎么处理这几种情况,于是大家都自由发挥。我想反驳,但发现他说得对。我把这个函数的命名从动词改成了名词,调用方全懵了。这大概就是程序员的人生吧