我是非常不喜欢使用Swagger的！其他语言我不知道，但是我作为写CSharp的，非常不喜欢！也许是我WebApi做少了，或者对于Swagger的理解太肤浅了(先找补一下！)。
我并不喜欢使用Swagger的原因有两点；第一点就是它生成的Api文档不美观、不直观。第二点是项目稍微复杂一点，Swagger就胜任不了工作了！
我们都知道Swagger是根据项目的XML文档生成的Api文档的，但是很多情况下，我们的XML生成不全的话，是会影响Api的显示的。
打个比方，就好比我之前的公司的业务框架最开始是被设计成插件式开发的，做法就是将一些功能分开开发，然后放在一个文件夹里面进行动态读取。在网站刚运行的时候，网站所加载的程序只有一些基础功能，比如说授权接口、登录接口以及Rest入口。当前端调用WebApi接口时，由Rest入口统一分配路由，当路由所指向的Api地址所在的插件未加载，此时会加载一次该插件，后续不再加载。
但是，这种做法显然就和Swagger的逻辑是不一样的，所以我即使使用了Swagger，它也只能显示一些基础接口出来。
有些时候我们需要对外公开我们自己的接口，这时候显然不能直接扔一个Swagger的OpenApi的地址给第三方去使用，我们往往需要自己编辑接口文档给第三方，这样很不方便。
这就是我一开始不使用Swagger的原因，一开始我们是程序员自己手写Api文档，后面我们就自己写了一套自己的OpenApi文档系统，可以控制相应权限的人能够看到哪些接口，我们自己内部的人又可以看到哪些接口。
第二张图片是我当初自己写的文档，国内早期很多互联网公司的开放平台基本上都是遵循这种文档格式，现在的也没有太大变化。
后来到了另一家公司，研发总监强制要求用Swagger，于是我就抛弃了原来的写法，改成了在项目加载时加载所有插件，或者将所有接口都写在一个项目里。
但是不久之后新的问题又出现了，就是当实体有继承的时候，有些情况下Swagger也会出问题，具体什么问题我也给忘了，好像是继承的类里面有什么特殊类型的字段导致的。最后没有办法，只能放弃继承，将实体的重复字段全部写到原先每一个子实体里面去。
然后就是Swagger文档的样式问题，我对接过很多互联网公司的OpenApi，像Swagger这样的文档样式我是接受不了的！当然了，NuGet上有很多第三方的针对Swagger文档的样式包，也许是我没研究透，会出各种各样的问题！
最后，我还是决定如果不是公司要求，我是不会去用Swagger！不是它不够好，而是我不喜欢它！
#程序员# #编程# #编程语言#
