命名是代码里唯一需要同时考虑机器和人的地方。我笑了笑,决定不解释。我把它改成了更长的全拼,可读性上去了,敲起来手疼。这大概就是程序员的人生吧

我给这个常量起了个解释性的名字,比原来长了一倍。我盯着屏幕沉默了十分钟。我把词典翻了个遍,找到了一个自认为很优雅的词。果然现实比段子更精彩

写公共组件需要起一个全组都信服的名字,我们开了三次会。我盯着屏幕沉默了十分钟。我发现这个名字和系统保留字冲突,只能加后缀。这条经验值直接拉满

我在命名上纠结了十分钟,最后用了 ctx。我先确认了一遍前置条件,再动手。我把这个接口的返回结构命名统一了,前端不用再猜。从此我多了一条团队规约

我给这个变量想了个准确的名字,它有二十四个字符。我把手上的资料翻出来又读了两遍。我把这个类的名字拆成了两个,职责也拆开了。感动,然后我学到了新的一课

写公共组件需要起一个全组都信服的名字,我们开了三次会。我把手上的资料翻出来又读了两遍。我把这个接口的返回结构命名统一了,前端不用再猜。幸好之前留了备份

我给这个变量想了个准确的名字,它有二十四个字符。我在心里把涉及的所有环节都过了一遍。我把这个数据库字段名和 Java 属性名对齐了。办公室安静得能听见键盘声

这个字段叫 data,而项目里有六十个叫 data 的字段。我在心里点了点头。我发现这个名字里有三个错别字,全项目都在用。我把它写进了组内的避坑文档第一章

我给这个函数起了个动词开头的名字,它其实什么也不做。我默默记下了这句话。我把这个数据库字段名和 Java 属性名对齐了。那一刻我觉得自己还是很专业的

命名规范的存在是为了让人放弃个性化。我盯着屏幕,觉得这才是我的一天。我把这个接口的命名改得更像业务了,技术同学看不懂。复盘会上我们把它列成了案例