一、创建NET Core API项目

NET Core版本:NET Core 2.2

1.创建core web应用程序

Net Core Web Api 配置Swagger_Core

2.选择API

Net Core Web Api 配置Swagger_Core_02

3.下图为生成后的项目

Net Core Web Api 配置Swagger_Core_03

二、安装Swagger

1.打开NuGet包管理器

Net Core Web Api 配置Swagger_Core_04

2.搜索Swashbuckle.AspNetCore安装在项目上

Net Core Web Api 配置Swagger_Web Api Swagger_05

3.点击我接受

Net Core Web Api 配置Swagger_Web Api Swagger_06

三、配置Swagger

对于ConfigureServices和Configure的配置点击可参考

1.ConfigureServices配置服务

配置Swagger生成器服务

services.AddSwaggerGen(c =>
{
    c.SwaggerDoc("v1", new OpenApiInfo { Title = "My API", Version = "v1" });
});

new OpenApiInfo需要引入Microsoft.OpenApi.Models
using Microsoft.OpenApi.Models;

2.Configure配置请求管道

JSON文档和Swagger UI的中间件

app.UseSwagger();
app.UseSwaggerUI(c =>
{
    c.SwaggerEndpoint("/swagger/v1/swagger.json", "NetCoreWebApiSwagger V1");
    c.RoutePrefix = string.Empty;
});

设置c.RoutePrefix = string.Empty;
可以直接访问http://localhost: 查看SwaggerUI页面

示例:

Net Core Web Api 配置Swagger_配置Swagger_07

3.清除 启动地址api/values

Net Core Web Api 配置Swagger_Web Api Swagger_08


删除默认地址api/values

Net Core Web Api 配置Swagger_配置Swagger_09

三、运行项目

Net Core Web Api 配置Swagger_配置Swagger_10