SwaggerGenOptions.IncludeXmlComments

SwaggerGenOptions.IncludeXmlComments 是 ASP.NET Core 中的一个配置项，它用于配置 Swagger UI 以包括 XML 文档注释，这有助于自动生成更为丰富的 API 文档。在启用这一配置后，Swagger 将会解析项目中 XML 文件的注释内容，并将这些注释内容作为 API 文档的一部分展示。开发者通常在 API 控制器或模型类的上方编写 XML 注释，这些注释可以描述 API 的功能、参数、返回类型等信息。通过这种方式，Swagger 能够展示出更加详细和用户友好的 API 文档，帮助开发者和使用者更好地理解和使用 API。

要启用 IncludeXmlComments 功能，你需要在 Startup.cs 的 ConfigureServices 方法中配置 Swagger 服务，并指定包含 XML 注释的文件路径。例如：

services.AddSwaggerGen(c =>
{
    c.SwaggerDoc("v1", new OpenApiInfo { Title = "My API", Version = "v1" });
    c.IncludeXmlComments(Path.Combine(AppContext.BaseDirectory, "MyProject.xml"));
});

这段代码会生成一个名为 "v1" 的 Swagger 文档，并且会读取项目基础目录下名为 "MyProject.xml" 的文件中的 XML 注释。