在 .NET Core 2.2 中使用 NSwag

参考 Get started with NSwag and ASP.NET Core 使用 NSwag 时，发现在 .NET Core 2.2.0、 NSwag.AspNetCore 12.0.5 中 services.AddSwagger() 和 app.UseSwaggerUi3WithApiExplorer() 方法已经被弃用了，需要改用对应的 AddSwaggerDocument()、UseSwagger() 和 UseSwaggerUi3() 方法。

安装 NSwag.AspNetCore NuGet 包

Install-Package NSwag.AspNetCore

Startup.cs

using NSwag.AspNetCore;

在 Startup.ConfigureServices 中注册 Swagger Document 服务。

// Register the Swagger services
services.AddSwaggerDocument();

在 Startup.Configure 启用 Swagger UI。

// Register the Swagger generator and the Swagger UI middlewares
app.UseSwagger().UseSwaggerUi3();

默认开启了属性首字母小写。

启动后打开 http://localhost:5000/swagger/ 访问 Swagger UI 页面。