这个名字我改了三次,最后一次改回了最初。我拉了个小群,把相关同学都叫了进来。我在心里给这个新起的名字投了一票,然后被否了。好在最后有惊无险

命名规范的存在是为了让人放弃个性化。我把这个类的名字加了 Impl 后缀,其实只有一个实现。这大概就是程序员的人生吧

命名里最忌讳的是缩写,尤其是自己发明的缩写。我抬起头看了看周围,大家都一样。我发现有的工具类叫 Utils,有的叫 Helper,还有叫 Util。幸好之前留了备份

我在命名上纠结了十分钟,最后用了 ctx。我把相关的记录都翻了出来做对照。我最后把它命名为 handler,虽然它并不处理任何东西。世界瞬间清净了

接口命名规范写了三页文档,线上接口还是叫 /api/getDataNew2。我盯着屏幕沉默了十分钟。我打开了命名生成网站,随手点了一个,居然还挺合适。真香定律准时生效

命名规范里没写怎么处理这几种情况,于是大家都自由发挥。我想了想,觉得这话没法接。我发现这个名字和系统保留字冲突,只能加后缀。从此我多了一条团队规约

我给这个接口起名时考虑了三方:上游、下游和未来的我。我默默打开了编辑器,准备一步步验证。我把这个变量从 data 改成了 result,语义清晰了一点点。真香定律准时生效

好的命名让人少看两遍注释,坏的命名让人多写三段注释。我抬起头看了看周围,大家都一样。我发现这个名字和系统保留字冲突,只能加后缀。幸好之前留了备份

变量命名二选一:data 和 data2,顶级架构师的纠结就到这了。我把这个变量的命名从缩写展开,代码长了两行。从此我多了一条团队规约

接口文档写着返回三个字段,实际返回了五个,还有一个叫 extra 的神秘字段。我把手上的资料翻出来又读了两遍。我在心里给这个变量起了个名,叫 whatever,第二天就后悔。好在最后有惊无险