首先我創建一個。net core項目，我使用的工具是vs2019

這里需要注意的是，看情況選擇是否開啟身份驗證，一般是沒有需求的，這里因為我是測試使用所以需要取消勾兌為https配置，并且我沒有啟用docker支持，因為這個

項目我只是寫接口，所以我創建的是一個webapi項目

點擊創建，生成項目

因為要使用swagger，所以我們需要安裝指定的組件包，現在我們使用nuget安裝組件

安裝后我們需要去startup中進行配置

首先我們在ConfigureServices中盡心注冊swagger服務

//注冊swagger服務
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文件

接著我們運行我們的項目

已經看到我們已經出現了swagger的界面，那么我們嘗試一下調用

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

我們接著去ConfigureServices中配置

再次運行項目查看

如我們所愿，備注都已經出來了