Swagger+ReDoc最完善的API文档

开启swagger注释

项目设置勾选“文档文件”
加载文档文件

var builder = WebApplication.CreateBuilder(args);
builder.Services.AddEndpointsApiExplorer();
builder.Services.AddSwaggerGen(c =>
{
    c.SwaggerDoc("v1", new()
    {
        Title = builder.Environment.ApplicationName,
        Version = "v1",
    });
    var basePath = AppContext.BaseDirectory;
    var xmlPath = Path.Combine(basePath, $@"{builder.Environment.ApplicationName}.xml");
    c.IncludeXmlComments(xmlPath, true);
});
var app = builder.Build();
if (app.Environment.IsDevelopment())
{
app.UseSwagger();
app.UseSwaggerUI(c => c.SwaggerEndpoint("/swagger/v1/swagger.json",
$"{builder.Environment.ApplicationName} v1"));
}
app.MapGet("/swag", () => "Hello Swagger!");
app.Run();