Swagger在ASP.NET Core中需安装Swashbuckle.AspNetCore NuGet包配置AddSwaggerGen、UseSwagger、UseSwaggerUI中间件启用XML注释与ProducesResponseType解析并适配部署路径。Swagger在ASP.NET Core里不是插件是NuGet包中间件组合Swagger文档生成在ASP.NET Core中靠的是 Swashbuckle.AspNetCore 这个官方推荐的NuGet包不是内置功能也不是“装个插件就完事”。它由三部分组成API描述SwaggerGen、UI渲染SwaggerUI和中间件管道集成。漏掉任一环页面打不开或文档为空。必须安装 Swashbuckle.AspNetCore6.4 支持 .NET 6/7/8别用老版本 SwashbuckleProgram.cs 里要调用 AddSwaggerGen() 和 UseSwagger() UseSwaggerUI()顺序不能反——UseSwagger() 必须在 UseRouting() 之后、UseEndpoints() 之前控制器方法没加 HTTP 方法特性如 [HttpGet]或没启用控制器路由MapControllers()SwaggerGen 就扫描不到接口文档空白Controller参数不显示多半是没开XML注释或没配 IncludeXmlCommentsSwagger默认不读取C# XML注释所以即使你写了 /// summary/summary文档里照样没说明。想让参数、返回值、方法描述出现得手动打开开关并确保编译时生成XML文件。项目文件.csproj里加GenerateDocumentationFiletrue/GenerateDocumentationFileProgram.cs 中配置 AddSwaggerGen 时显式调用 c.IncludeXmlComments()路径要用 AppContext.BaseDirectory 拼接例如c.IncludeXmlComments(Path.Combine(AppContext.BaseDirectory, YourApp.xml))XML文件名默认是程序集名.xml大小写敏感如果发布后找不到文件检查发布输出目录是否真有该文件而不是只在Debug目录下存在ProducesResponseType 不生效因为没配 SwaggerGen 的响应类型推导标注了 [ProducesResponseType(typeof(User), StatusCodes.Status200OK)] 却在Swagger UI里看不到响应模型问题常出在两个地方一是没启用响应类型自动发现二是泛型或复杂类型没正确注册。 知网AI智能写作 知网AI智能写作写文档、写报告如此简单