引入包

nuget包： Swashbuckle.AspNetCore（最新稳定版）

配置

1.配置Startup类Configureservices方法的相关配置

swagger的作用和配置使用

 1 public void Configureservices(IserviceCollection services)
 2         {
 3             //swagger服务配置
 4             services.AddSwaggerGen(c =>
 5             {
 6                 c.SwaggerDoc("V1", new Microsoft.openApi.Models.OpenApiInfo
 7                 {
 8                     Version = "v1",//接口文档版本
 9                     title = "我的接口文档1.0",//接口文档标题
10                     Description = "我的第一个swagger文档",//接口文档描述
11                     Contact = new Microsoft.openApi.Models.OpenApiContact { Name = "张华", Url = new Uri("http://baidu.com"), Email = "nice0320@163.com" },
12                     License = new Microsoft.openApi.Models.OpenApiLicense { Name = "张华", Url = new Uri("http://baidu.com") }
13                 });
14             });
15             services.AddControllers();
16         }

1.配置Startup类Configureservices方法的相关配置

2.配置Startup类Configure方法的中间件

swagger的作用和配置使用

 1 public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
 2         {
 3             if (env.IsDevelopment())
 4             {
 5                 app.UseDeveloperExceptionPage();
 6             }
 7 
 8             app.UseRoutIng();
 9 
10             app.UseAuthorization();
11 
12             app.UseEndpoints(endpoints =>
13             {
14                 endpoints.MapControllers();
15             });
16 
17             ///swagger中间件启动配置
18             app.UseSwagger();
19             app.UseSwaggerUI(a => {
20                 a.SwaggerEndpoint("/swagger/V1/swagger.json", "中间件启动配置，我的第一个swagger文档");
21                 //如果是为空 访问路径就为 根域名/index.html,注意localhost:8001/swagger是访问不到的
22                 //路径配置，设置为空，表示直接在根域名（localhost:8001）访问该文件
23                 // c.RoutePrefix = "swagger"; // 如果你想换一个路径，直接写名字即可，比如直接写c.RoutePrefix = "swagger"; 则访问路径为 根域名/swagger/index.html
24                 a.RoutePrefix = String.Empty;//路由
25             });
26         }