背景
我们在使用Swagger生成
.NET Core Web Api
项目接口文档时候,发现接口的
入参
和
出参
的注释是看不见的,如下:
但是我想要结果是这样:
原因分析以及方案
为什么没有显示注释呢,注释确实写了呀?
原因很简单,通常我们用Swagger的时候只加载当前项目生成的
xml
注释文件,例如这样:
var xmlPath = Path.Combine(basePath, "AppData", "XXX.WebAPI.xml");
services.AddSwaggerGen(c =>
{
c.