😂 IT段子

接口文档写着返回三个字段，实际返回了五个，还有一个叫 extra 的神秘字段。我盯着屏幕沉默了十分钟。我发现这个名字的拼写是错的，但已经上线不敢改。第二天这个方案就变成了团队标准做法

接口设计评审会上，我为一个字段该叫 name 还是 title 争了二十分钟。我打开记录从头到尾扫了一遍。我在评审会上被问到这个名字的语义，我沉默了。感动，然后我学到了新的一课

新同事问这个类为什么叫 Manager2，我说因为 Manager 被 2018 年的人用过了。我笑了笑，决定不解释。我把这个测试方法的命名写成了完整一句话，非常长。复盘会上我们把它列成了案例

接口设计评审会上，我为一个字段该叫 name 还是 title 争了二十分钟。我决定先把手上的事情做完再处理这件事。我把这个模块的命名缩写展开了一遍，比原来还长。同事说这波操作可以写进新人培训教材

命名是编程里最难的两件事之一，另一件是让别人也觉得它好。我抬起头看了看周围，大家都一样。我把这个方法的命名从 list 改成了 query，因为要分页。复盘会上我们把它列成了案例

程序员最难的两个问题：架构怎么设计，和这个变量叫什么。我想反驳，但发现他说得对。我在心里给这个字段想了个业务上的名字，产品看不懂

我给这个变量想了个准确的名字，它有二十四个字符。我拉了个小群，把相关同学都叫了进来。我把这个函数的命名从 save 改成了 persist，回调全改了。复盘会上我们把它列成了案例

我给这个接口起名时考虑了三方：上游、下游和未来的我。这套流程走下来，我从头到尾又确认了一遍。我把这个接口的路径重新起了一遍，从动词改成了资源。办公室安静得能听见键盘声

接口命名规范写了三页文档，线上接口还是叫 /api/getDataNew2。我在心里把涉及的所有环节都过了一遍。我在心里给这个新功能定了个命名基调，然后被推翻了。连茶水间都安静了

我把这个模块的名字从中文拼音换成了英文，团队里两种都有。我把这个枚举的名字统一了前缀，可读性提升明显。第二天这个方案就变成了团队标准做法