.NET Core Api使用配置Swagger

1、项目下载NuGet包

Swashbuckle.AspNetCore.Swagger: 一些模型实体定义
Swashbuckle.AspNetCore.SwaggerGen: Swagger生成器
Swashbuckle.AspNetCore.SwaggerUI：Swagger UI工具

2、配置相关信息

2.1 在配置文件Startup中配置：

ConfigureServices：

public void ConfigureServices(IServiceCollection services)
        {
            services.AddControllers();
            //设置跨域Cores
            services.AddCors(option => option.AddPolicy("cors", 
                c => c.AllowAnyOrigin().AllowAnyHeader().AllowAnyMethod()));
            //配置swagger
            services.AddSwaggerGen(c => {
                c.SwaggerDoc("v1", new Microsoft.OpenApi.Models.OpenApiInfo { Title = "SHI_NOTE", Version = "v1" });

                var xmlfile = $"{Assembly.GetExecutingAssembly().GetName().Name}.xml";
                var xmlpath = Path.Combine(AppContext.BaseDirectory, xmlfile);
                c.IncludeXmlComments(xmlpath);

            }
            );
        }

Configure：

 app.UseSwagger();
            app.UseSwaggerUI(
                c => c.SwaggerEndpoint("/swagger/v1/swagger.json", "SHI_NOTE")
                );

2.2 在配置Properties中launchSettings.json进行修改初始接口显示（把launchUrl的改为"swagger/index.html"）：

  "profiles": {
    "IIS Express": {
      "commandName": "IISExpress",
      "launchBrowser": true,
      "launchUrl": "swagger/index.html",
      "environmentVariables": {
        "ASPNETCORE_ENVIRONMENT": "Development"
      }
    },

2.3 自动生成xml文件

这里可以运行接口看一下效果，应该会显示成这样：

我的项目已上传github（https://github.com/Shiqing0602/.NetCore-WEBAPI-EFCore-SqlServer.）有需要的朋友可以自行观看。