知识卡片
最小API是深刻理解问题的标志
内容
完美的设计不是无法再添加什么,而是无法再删去什么——这个标准同样适用于API设计:暴露给使用者 的方法和参数越少,接口越容易理解,维护者也能把更多精力投入到把这些少数方法做到极致完善。 有意识地不解决某些边缘问题、把API范围收窄,反而能让核心问题解决得更彻底。一个很小很简单的 API通常不是能力不足,而是设计者对问题本质有更深刻理解的标志。
参考来源
- 位置:《SRE:Google运维解密》第9章《简单化》"最小API"一节(源文件:_epub-src/OEBPS/Text/0008_0007.xhtml)
- 结论依据:原文引用圣埃克苏佩里"不是在不能添加更多的时候,而是没有什么可以去掉的时候,才能达到完美",并主张暴露的方法参数越少API越易理解,称"一个很小的,很简单的API通常也是一个对问题深刻理解的标志"。
- 原始内容:“不是在不能添加更多的时候,而是没有什么可以去掉的时候,才能达到完美……我们向API消费者提供的方法和参数越少,这些API就越容易理解……一个很小的,很简单的API通常也是一个对问题深刻理解的标志。”