首先我創(chuàng)建一個(gè)。net core項(xiàng)目，我使用的工具是vs2019

這里需要注意的是，看情況選擇是否開啟身份驗(yàn)證，一般是沒有需求的，這里因?yàn)槲沂菧y試使用所以需要取消勾兌為https配置，并且我沒有啟用docker支持，因?yàn)檫@個(gè)

項(xiàng)目我只是寫接口，所以我創(chuàng)建的是一個(gè)webapi項(xiàng)目

點(diǎn)擊創(chuàng)建，生成項(xiàng)目

因?yàn)橐褂胹wagger，所以我們需要安裝指定的組件包，現(xiàn)在我們使用nuget安裝組件

安裝后我們需要去startup中進(jìn)行配置

首先我們在ConfigureServices中盡心注冊swagger服務(wù)

//注冊swagger服務(wù)
services.AddSwaggerGen(c =>
{
// 添加文檔信息
c.SwaggerDoc("v1", new Info { Title = "CoreWebApi", Version = "v1" });
});

然后我們在Configure中啟用swagger中間件

// 啟用Swagger中間件
app.UseSwagger();

// 配置SwaggerUI
app.UseSwaggerUI(c =>
{
c.SwaggerEndpoint("/swagger/v1/swagger.json", "CoreWebApi");
c.RoutePrefix = string.Empty;
});

接著配置的xml文件

接著我們運(yùn)行我們的項(xiàng)目

已經(jīng)看到我們已經(jīng)出現(xiàn)了swagger的界面，那么我們嘗試一下調(diào)用

忽然發(fā)現(xiàn)我們這個(gè)上面并沒有每個(gè)接口的備注，這是咋回事那？看來我們還需要配置一些東西

我們接著去ConfigureServices中配置

再次運(yùn)行項(xiàng)目查看

如我們所愿，備注都已經(jīng)出來了