接口类型 命名修改的代价

只是一个名字, 不影响使用.

但当使用接口的人看到这样不一致的命名方式, 心中难免泛起 WTF.

当项目比较庞大, 开发维护的时候较长时, 这种问题难免发生.

比如 https://open.dingtalk.com/document/org/push-events 中要求的结构是:

{
  "msg_signature":"111108bb8e6dbce3c9671d6fdb69d1506xxxx",
  "timeStamp":"1783610513",
  "nonce":"123456",
  "encrypt":"1ojQf0NSvw2WPvW7LijxS8UvISr8pdDP+rXpPbcLGOmIxxxx"
}

msg_signature 和 timeStamp 同时存在. 其实还有一种写法 timestamp. 文档中针对相同的数据也还有一种命名 signature.

不是专门为了吐槽钉钉, 而是这种问题在许多地方都出现. 比如我们的项目中就部分混用了 created_at 和 createdAt.

如果有足够的类型提醒, 其实不至于出错. 但这种混乱, 如果能改一致会更好.

但是代价, 似乎不小. 哪怕只是在内部项目中, 一个普通程序员用一天时间, 这样的成本, 团队都可能不会去付出.

大家怎么看这种代价?

请不要把自己比作板砖工, 向上两级思考问题.