解决swagger跨项目或跨程序集注释不显示问题

  • Post author:
  • Post category:其他


背景

我们在使用Swagger生成

.NET Core Web Api

项目接口文档时候,发现接口的

入参



出参

的注释是看不见的,如下:

190828-swagger-no-summary.png

但是我想要结果是这样:

190828-swagger-summary.png

原因分析以及方案

为什么没有显示注释呢,注释确实写了呀?

190828-swagger-model.png

原因很简单,通常我们用Swagger的时候只加载当前项目生成的

xml

注释文件,例如这样:

var xmlPath = Path.Combine(basePath, "AppData", "XXX.WebAPI.xml");
services.AddSwaggerGen(c =>
{
    c.