基本原则

  • 专一： 一个API的功能应该是单一的，需要能够很容易的解释和理解，也就会更好用

  • 尽可能的小：小有很多的优势，易于理解和维护

  • 尽量少的外部依赖：减少使用者的成本

  • 设计不被实现影响:不要暴漏实现细节给用户.尽可能少的暴露，不止是内部细节，对于不必要的接口尽量不要发布，比如使用不多的功能， 可以暂时不暴露接口

  • 良好的命名:尽量做到自描述

  • 完善的文档

  • 考虑性能