ASP.NET Core 项目集成 Swagger 需四步：1. 安装 Swashbuckle.AspNetCore 包；2. 在 Program.cs 中配置 AddEndpointsApiExplorer、AddSwaggerGen 及 UseSwagger/UseSwaggerUI；3. 启用 XML 注释并配置读取路径以增强文档信息；4. 可选支持多版本，通过 SwaggerDoc 和 SwaggerEndpoint 实现。

ASP.NET Core 项目中集成 Swagger（即 Swashbuckle.AspNetCore）是生成 OpenAPI 接口文档最常用、最标准的方式。它能自动扫描控制器和 API 方法，生成交互式文档页面，并支持测试接口。

1. 安装 Swashbuckle.AspNetCore 包

在项目中通过 NuGet 安装核心包：

• Swashbuckle.AspNetCore（主包，含生成器、UI 和中间件）

可通过 CLI 命令安装：

dotnet add package Swashbuckle.AspNetCore

2. 配置服务与中间件（Program.cs）

.NET 6+ 项目统一在 Program.cs 中配置：

• 调用 AddEndpointsApiExplorer()（必需，为 API 端点提供元数据）
• 调用 AddSwaggerGen() 添加 Swagger 生成器
• 在管道中使用 UseSwagger() 和 UseSwaggerUI()

示例代码：

var builder = WebApplication.CreateBuilder(args);
builder.Services.AddEndpointsApiExplorer();
builder.Services.AddSwaggerGen();

var app = builder.Build();
app.UseSwagger();
app.UseSwaggerUI();

3. 添加接口注释与增强文档信息

默认只显示方法名和路径。要显示更详细的描述、参数说明、返回值等，需启用 XML 注释：

Gaga

曹越团队开发的AI视频生成工具

1151 查看详情

• 在项目文件（.csproj）中添加：<generatedocumentationfile>true</generatedocumentationfile>
• 在 AddSwaggerGen() 中配置读取 XML 文件：

builder.Services.AddSwaggerGen(c =>
{
  c.IncludeXmlComments(Path.Combine(AppContext.BaseDirectory, "YourProjectName.xml"));
});

并在控制器/方法上写三斜杠注释，例如：

///

获取用户列表

/// 用户集合
[HttpGet("users")]
public IEnumerable GetUsers() => ...;

4. 支持多版本 OpenAPI 文档（可选）

如需支持 v1/v2 多版本 API，可配置多个 Swagger 文档：

• 在 AddSwaggerGen() 中定义多个 c.SwaggerDoc("v1", ...)
• 用 UseSwaggerUI() 指定默认版本和切换入口

示例片段：

builder.Services.AddSwaggerGen(c =>
{
  c.SwaggerDoc("v1", new OpenApiInfo { Title = "My API v1", Version = "v1" });
  c.SwaggerDoc("v2", new OpenApiInfo { Title = "My API v2", Version = "v2" });
});

app.UseSwaggerUI(c =>
{
  c.SwaggerEndpoint("/swagger/v1/swagger.json", "My API V1");
  c.SwaggerEndpoint("/swagger/v2/swagger.json", "My API V2");
});

基本上就这些。启动应用后访问 /swagger 即可看到交互式文档页面，所有标记了 HTTP 特性的控制器方法都会自动列出。

以上就是ASP.NET Core怎么使用Swagger OpenAPI接口文档生成方法的详细内容，更多请关注其它相关文章！

# js  # json  # app  # .net  # 文档  # 多个  # 可选  # 如何将  # 序列化  # 并在  # 相关文章  # 中文网  # 解决问题  # 只显示  # seo网站优化实战  # 东莞推广营销多少钱  # 汕尾网站建设软件  # 遵义租房网站建设  # 泰安网络公司优化网站  # 随州工厂网站优化哪家好  # 德网站建设论文  # 哈尔滨网站建设专业现状  # 青山seo排名收费  # 北京网站建设的服务