應變而優

如何寫好一個API？

優秀 的 API即好記住又明確，促進代碼可讀性、準確性和高效性，幫助開發者走向成功。

我稱這些設計方向爲「第一階層」，由於它們是類庫開發者須要關注的第一件事情。你可能不得不捨棄其中一部分並做出權衡，但至少它們在你腦海中游走過。

可是，只要你還未將此「流浪者」發送至火星，你的代碼一直都有可能發生變化，API使用者的代碼也是如此。

我認識的一些優秀API開發者不會停留在像可讀性這樣的「第一階層」方向上，他們將盡量多的努力奉獻給我稱爲「第二階層」的API設計：使用此API的代碼如何隨着時間的推移而發展。

微小的需求變化能夠使最優雅的代碼分崩離析。

優秀 的 API 會準備好這些。它們預計到你會想要移動一些代碼、複製粘貼一些部分、重命名、將特殊狀況提取成可複用幫助程序、將抽象展開回特定的情景、hack一下、優化瓶頸、放棄一部分而後從新開始、犯了一個錯誤、在原由和影響之間遊走、修復bug、審查修復代碼。

優秀 的APIs不只使你走向成功，還能助你 停留 在那。

它們應變而優。

翻譯原文Optimized for Change(2018-12-12)