如何在ASP.NET Core 6的services.AddSwaggerGen中添加两个Swagger版本

要在ASP.NET Core 6中实现Swagger多版本功能，需在Startup类的ConfigureServices方法内，对services.AddSwaggerGen进行如下配置，添加两个版本的Swagger文档定义：

services.AddSwaggerGen(
    config =>
    {
        // 配置v1.1版本的Swagger文档
        config.SwaggerDoc("v1.1", new OpenApiInfo 
        { 
            Title = "BookingApis V1", 
            Version = "v1.1", 
            Description = "Developed By Demon" 
        });
        // 配置v2版本的Swagger文档
        config.SwaggerDoc("v2", new OpenApiInfo 
        { 
            Title = "BookingApis V2", 
            Version = "v2", 
            Description = "Developed By Demon" 
        });
    }
);

关键说明 #

• 每个SwaggerDoc调用对应一个API版本，第一个参数是版本的唯一标识（如v1.1、v2），Swagger UI会通过这个标识切换不同版本的API文档。
• OpenApiInfo对象用于定义该版本文档的标题、版本号和描述信息，方便开发者快速识别不同版本的API。
• 该配置是实现Swagger多版本展示的核心必要设置，后续还需在控制器上通过[ApiVersion]和[MapToApiVersion]特性标记对应版本的接口，才能完整实现多版本API的Swagger展示。

内容的提问来源于stack exchange，提问作者elham hassanzadeh