1、首先创建一个.net core Api 项目
2、在程序包管理器控制台输入命令(Install-Package Swashbuckle.AspNetCore -Version 5.6.3) 或者在Nuget包中安装Swashbuckle.AspNetCore
3、将 Swagger 生成器添加到服务集中
代码: services.AddSwaggerGen();
4、启用中间件为生成的 JSON 文档和 Swagger UI 提供服务
代码:
app.UseSwagger(c =>
{
c.SerializeAsV2 = true;
});
app.UseSwaggerUI(c =>
{
c.SwaggerEndpoint("/swagger/v1/swagger.json", “My API V1”);
c.RoutePrefix = string.Empty;
});
5、添加Api
6、点击运行
7、Swagger上并没有显示相应的注释
(1)、左击项目,点击属性,勾上生成xml文件
2、在服务集中添加相应的配置
代码:services.AddSwaggerGen(c =>
{
var xmlFile = $"{Assembly.GetExecutingAssembly().GetName().Name}.xml";
var xmlPath = Path.Combine(AppContext.BaseDirectory, xmlFile);
c.IncludeXmlComments(xmlPath);
});
3、运行
当如果存在什么问题,请在评论区留言谢谢,新博主,做的不好的,请指正,