基于 .NET 6.0 Swagger 生成离线文档

dotnet add package SwaggerDoc --version 1.0.1

services.AddSwaggerDoc(); //（用于MarkDown生成）

services.AddSwaggerGen(c =>
{
    c.SwaggerDoc("v1", new OpenApiInfo {Title = "Swagger API 文档", Version = "v1", Description = "API 文档"});
    // 添加枚举过滤器，在文档中显示枚举的描述信息
    c.DocumentFilter<SwaggerEnumFilter>(new object[]
    {
        // 枚举所在的程序集
        new[] {Assembly.GetExecutingAssembly()}
    });
    c.IncludeXmlComments("Samples.xml");
});

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