命名是代码里唯一需要同时考虑机器和人的地方。我在心里给这个函数起了个名,叫 doSomething,非常准确。这大概就是程序员的人生吧

接口文档写着返回三个字段,实际返回了五个,还有一个叫 extra 的神秘字段。我决定先把手上的事情做完再处理这件事。我发现这个名字的拼写是错的,但已经上线不敢改。从此我多了一条团队规约

命名里最忌讳的是缩写,尤其是自己发明的缩写。我把它记在心里,没跟任何人说。我发现这个名字里有数字,是从别的项目复制过来的。真香定律准时生效

接口文档写着返回三个字段,实际返回了五个,还有一个叫 extra 的神秘字段。我把相关的记录都翻了出来做对照。我发现有的工具类叫 Utils,有的叫 Helper,还有叫 Util。这大概就是程序员的人生吧

命名是代码里唯一需要同时考虑机器和人的地方。我不知道该说什么,就笑了笑。我在编辑器里敲了又删,删了又敲,最后还是叫 data。我沉默了,但心里是服的

接口文档写着返回三个字段,实际返回了五个,还有一个叫 extra 的神秘字段。我盯着屏幕沉默了十分钟。我在心里给这个命名纠结了十分钟,最后用了默认的。同事说这波操作可以写进新人培训教材

命名是代码里唯一需要同时考虑机器和人的地方。我想了想自己这些年,好像确实如此。我把词典翻了个遍,找到了一个自认为很优雅的词。真香定律准时生效

接口文档写着返回三个字段,实际返回了五个,还有一个叫 extra 的神秘字段。我先给自己泡了杯茶,做好了打持久战的准备。我把这个接口的返回结构命名统一了,前端不用再猜。我把它写进了组内的避坑文档第一章

接手祖传代码,看到一个叫 tmp1 的变量,注释写着:别问,问就是历史遗留。我在心里把涉及的所有环节都过了一遍。我在心里给这个模块起了个代号,评审时没人听懂。从此我多了一条团队规约

接口文档写着返回三个字段,实际返回了五个,还有一个叫 extra 的神秘字段。我在心里把涉及的所有环节都过了一遍。我把这个变量从 data 改成了 result,语义清晰了一点点。我把这条经验写进了团队 wiki