.net6 webapi Swagger显示控制器为版本及接口注释

1.安装Nuget包:Swashbuckle.AspNetCore

2.使用Swagger中间件

builder.Services.AddEndpointsApiExplorer();

builder.Services.AddSwaggerGen(option =>
{

　　//要启用swagger版本控制要在api控制器或者方法上添加特性[ApiExplorerSettings(GroupName = "版本号")] 
　　typeof(ApiVersions).GetEnumNames().ToList().ForEach(version =>
　　{
　　　　option.SwaggerDoc(version, new OpenApiInfo()
　　　　{
　　　　　　Title = $"{version}:Api文档",
　　　　　　Version = version,
　　　　　　Description = $"{version}"
　　　　});
　　});

　　// xml文档绝对路径,你的api.xml文件在项目属性=》生成=》输出=》文档文件，xml文件路径可选可不选

　　var file = Path.Combine(AppContext.BaseDirectory, "你的api.xml");

　　// true : 显示控制器层注释

　　option.IncludeXmlComments(file, true);

　　// 对action的名称进行排序，如果有多个，就可以看见效果了。

　　option.OrderActionsBy(o => o.RelativePath);

})

app.UseSwagger();

//配置swagger.json
app.UseSwaggerUI(option =>
{
　　foreach (string version in typeof(ApiVersions).GetEnumNames())
　　{
　　　　option.SwaggerEndpoint($"/swagger/{version}/swagger.json", $"{version}");
　　}
});

3.其中ApiVersions可以是枚举，可以是任何集合，只要能更好的操作就行了