W24 · 把接口当契约.改了一个字段名,下游三个地方同时炸掉。这一周重新理解了「契约」这个词。2026年6月14日·1 分钟·232 字·日志#Weekly#Api#Engineering目录扫码在手机上阅读。MD海报朗读停止朗读正文内容,不包含页面工具和目录。问 AI摘要复制正文和提示词,让 AI 生成摘要与要点。结构复制正文和提示词,让 AI 提取结构和心智模型。AI 问答复制正文和提示词,让 AI 以问答方式帮助理解。复制 Markdown导出海报—一次天真的重命名. 字段叫错了名字,改过来是理所当然的事。但这个字段已经被小程序读了半年,也被两个脚本依赖着。 改动本身花了三分钟,善后花了两天。这两天里我一直在想:如果一开始就把它当成契约,会怎么做? —扩展,而不是替换. 答案很朴素:先加上新字段,让两者共存;让下游逐个迁移;确认没有人再读旧字段,才把它删掉。 慢,但每一步都是可回退的。而一次性的重命名,只有一个瞬间是安全的——就是没人在用它的时候。 —下周. 把这次的教训写进接口文档,顺便给旧字段加上一段注释,说明它为什么还活着。本周观察02 / 05← 上一篇W23 · 工具收敛下一篇 →W25 · 一次糟糕的回滚— 讨论GitHub评论.评论由 GitHub Discussions 承载。请围绕文章内容交流,并保持克制、友善。评论暂时没有加载出来。可以稍后刷新重试,或直接到 GitHub Discussions 参与讨论。← 全部文章
— 讨论
GitHub评论.
评论由 GitHub Discussions 承载。请围绕文章内容交流,并保持克制、友善。
评论暂时没有加载出来。可以稍后刷新重试,或直接到 GitHub Discussions 参与讨论。