如何让Swagger UI默认自动折叠所有API端点分组？

可以通过配置Swagger UI的启动参数实现默认折叠所有端点分组，具体步骤如下：

在你的app构建完成后，补充UseSwagger和UseSwaggerUI中间件配置，并设置DefaultExpandDepth = 0：

var app = builder.Build();

// 开发环境启用Swagger
if (app.Environment.IsDevelopment())
{
    app.UseSwagger();
    app.UseSwaggerUI(c =>
    {
        c.SwaggerEndpoint("/swagger/v1/swagger.json", "Guanajuato RolePlay API v1");
        // 设置默认折叠所有端点分组
        c.DefaultExpandDepth(0);
        // 可选：如果需要默认折叠模型定义区域，添加下面一行
        c.DefaultModelsExpandDepth(-1);
    });
}

app.UseHttpsRedirection();
app.UseCors();
app.UseAuthorization();

app.MapControllers();

app.Run();

参数说明： #

• DefaultExpandDepth(0)：将默认展开深度设为0，所有端点分组（Tag）会默认处于折叠状态（默认值为1，会自动展开所有分组）。
• DefaultModelsExpandDepth(-1)：可选配置，设为-1会默认折叠Swagger UI底部的模型定义区域，不需要默认展开模型时可以添加。

启动API后，Swagger UI里的所有端点分组就会默认保持折叠状态，需要查看时手动展开即可。

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