什么是Swagger，Swashbuckle和Swashbuckle？

Question

我的理解是：

• Swagger是编写文档的一种符号/规则。但是为什么它被称为一个框架(比如角/MVC)？
• 斯巴什巴克尔是一个程序(JavaScript?)生成文档(基于Swagger规则)。
• Swagger显示文档。它用斯瓦什巴克尔来做这个。

这个信息正确吗？如果不是，有人能用简单的术语解释Swagger，Swashbuckle和Swashbuckle的含义吗？

另外，如果我不使用这个API开发人员，我会失去什么呢？

Answer 1

Swagger是编写文档的一种符号/规则。但是为什么它被称为一个框架(比如角/MVC)？

它可能被称为“框架”，因为它的目的是提供一种系统的方式，在RESTful规范下标注任何OpenAPI服务的接口。这对开发人员来说是一件大事，因为规范是在著名的下由监督的。

Swashbuckle是一个程序(javascript ?)生成文档(基于Swagger规则)

Swashbuckle更多地是一个包(或一个库)，您可以在.NET Web项目中使用它。正如您正确指出的，它的目的是为您的项目生成Swagger规范。此外，Swagger包含在Swashbuckle中，所以如果您正在.NET中开发API，它确实是一个很好的一站式包商店。它几乎完全是用C#而不是JavaScript编写的。

Swagger显示文档。它用斯瓦什巴克尔来做这个。

是的，它确实以友好的方式展示了Swagger规范。然而，Swashbuckle并不是这方面的必要组成部分。除了我之前所说的，它们是完全相互排斥的。

另外，如果我不使用这个API开发人员，我会失去什么呢？

这现在已经进入了观点的范围，但我会尽量客观地看待这一点。我使用Swashbuckle来帮助为我的应用程序API创建客户端。在通过了实现学习曲线(不是很多)之后，这个包为我自己编写客户机节省了相当多的时间。对于小型应用程序来说，编写web客户端是件小事，但企业级应用程序往往会不断增长和/或在复杂性方面发生变化，因此完全自动化地创建/更新这些客户端是件好事。

简而言之，如果您决定不使用它，您必须选择另一种API客户端生成方法，或者自己编写/更新客户机。如果您只是在开发后端，这对您来说可能是完全没有意义的，但它肯定会帮助那些负责创建将使用您的API服务的客户端应用程序的人。

我希望这些答案是有帮助的。干杯!