推荐订阅源

1. 新建netcore项目

2. 使用nuget包安装 Swashbuckle.AspNetCore

使用RestorePackagesPath属性配置nuget包的路径（可选）

  <PropertyGroup>
    <TargetFramework>net5.0</TargetFramework>
      <RestorePackagesPath>..\packages</RestorePackagesPath>
  </PropertyGroup>

3. 勾选生成项目xml文件

 4.在Startup中添加代码

在ConfigureServices 中添加配置。

services.AddSwaggerGen(c =>
 {
    c.SwaggerDoc("v1", new OpenApiInfo { Title = "My API", Version = "v1" });
   
   var basePath = HostEnvironment.ContentRootPath;
   var xmlPath = Path.Combine(basePath, $"{typeof(Startup).Namespace}.xml");
   c.IncludeXmlComments(xmlPath, true);
});

在Configure中添加代码

 app.UseSwagger(); 
 app.UseSwaggerUI(c =>
 {
   c.SwaggerEndpoint("/swagger/v1/swagger.json", "My API V1");
 });

5.访问

/swagger （访问swagger页面。）

/swagger/v1/swagger.json  (查看异常页)