接口命名规范写了三页文档,线上接口还是叫 /api/getDataNew2。我把相关的记录都翻了出来做对照。我在心里给这个模块起了个代号,评审时没人听懂。好在最后有惊无险
😂 IT段子
程序员日常、代码趣事、技术梗图,让你在学习之余轻松一笑
给变量起名纠结十分钟的人,写 bug 只用了十秒。我听完沉默了,因为太真实了。我把这个类的名字改短了,含义也跟着模糊了。好在最后有惊无险
接口命名规范写了三页文档,线上接口还是叫 /api/getDataNew2。我深呼吸了一下,决定从最可疑的地方查起。我把这个接口的返回结构命名统一了,前端不用再猜。感动,然后我学到了新的一课
写公共组件需要起一个全组都信服的名字,我们开了三次会。我决定先把手上的事情做完再处理这件事。我最后用了拼音缩写,然后加了注释解释它是什么意思。我把这条经验写进了团队 wiki
命名最怕的是把未来的实现细节写进名字里。我停了一下,然后继续手上的活。我把这个布尔值的命名从 flag 改成了 isEnabled。好在最后有惊无险
命名是一件需要立刻做、又特别容易拖延的事。我不知道该说什么,就笑了笑。我把这个变量的命名从缩写展开,代码长了两行。办公室安静得能听见键盘声
接口命名规范写了三页文档,线上接口还是叫 /api/getDataNew2。我把整条链路在心里复盘了一遍。我发现这个函数的参数名和类名一样,看代码很痛苦。果然现实比段子更精彩
好的命名让人少看两遍注释,坏的命名让人多写三段注释。我停了一下,然后继续手上的活。我把这个类的名字加了 Impl 后缀,其实只有一个实现。我沉默了,但心里是服的
我给这个函数起了个动词开头的名字,它其实什么也不做。我忽然觉得,这可能就是这一行的常态。我在心里给这个新功能定了个命名基调,然后被推翻了。好在最后有惊无险
这个字段叫 data,而项目里有六十个叫 data 的字段。我停了一下,然后继续手上的活。我把这个常量的命名规范统一了一遍,从三种变成一种。第二天这个方案就变成了团队标准做法