应变而优
优秀的 API 设计分成两个级别。
第一级：优秀的 API 设计是既好记又明确的。它能促进代码的可读性、准确性和高效性，也能帮助开发者进入成功之坑。这是库开发者需要关注的首要事项。
第二级：使用此 API 的代码如何随时间的推移而发展。API 应变而优。
微小的需求变化可以使最优雅的代码支离破碎。优秀的 API 对这一点是有预期的。它们预料到你可能想移动一些代码、复制粘贴一部分、重命名、将一些特殊例子整合成一个通用且可复用的辅助函数、将一个抽象解构成一些具体实例、加一个 hack、优化一个瓶颈、抛弃一部分代码重写、犯了一个错误、在起因和结果间游走、修复一个 bug、审阅一个代码修复。
优秀的 API 不仅仅让你进入成功之坑里，而且能帮你驻留在那里。
它们应变而优。