api - API 什么时候会被过度设计？

Question

就目前情况而言，这个问题不太适合我们的问答形式。我们希望答案得到事实、引用资料或专业知识的支持，但这个问题可能会引发辩论、争论、民意调查或扩展讨论。如果您觉得这个问题可以改进并可能重新开放， visit the help center以获得指导。

已关闭 11 年前。

我鄙视使用过度设计的 API，因为它们不会让简单的事情变得简单。尽管如此，我正在为一个开源库设计一个 API，我开始觉得我陷入了过度设计的陷阱。我真的不能确定，因为当然，我写了这个该死的东西，所以它的工作原理对我来说比其他任何人都更明显。从开发人员的角度来看，您的 API 可能被过度设计的警告信号有哪些？

Answer 1

“从开发人员的角度来看，您的 API 可能被过度设计了，有哪些警告信号？”

没有用例。

如果您无法运行简单的“执行此操作”场景，那么您就没有设计出考虑到特定用例的有用 API。

您的文档应该是那些用例。

不直接解决用例的功能可能是过度设计的。