搭建Swagger框架时，浏览不到Swashbuckle.AspNetCore包的简单解决办法

最新推荐文章于 2025-06-08 09:02:21 发布

一条小白泽

最新推荐文章于 2025-06-08 09:02:21 发布

阅读量3.3k

点赞数

CC 4.0 BY-SA版权

分类专栏： Asp.Net学习记录文章标签： asp.net

本文链接：https://blog.youkuaiyun.com/qq_41802224/article/details/111095718

Asp.Net学习记录专栏收录该内容

7 篇文章

订阅专栏

本文介绍Swagger——一款用于RESTful接口文档自动生成及功能测试的工具。详细讲述了如何通过NuGet安装并配置Swagger到.NET Core Web API项目中，包括添加必要的命名空间、配置Swagger生成器和服务等步骤。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

什么是Swagger?

Swagger是一款RESTFUL接口的文档在线自动生成+功能测试的软件。

Swagger是一个规范和完整的框架，用于生成、描述、调用和可视化RESTFUL风格的Web服务。

详情请访问相关播客：Swagger简介

1、首先找到项目中的“依赖项”--->"管理NuGet程序包"

2、然后点开包源管理里面的设置：

3、复制如下链接，操作步骤如下：

https://api.nuget.org/v3/index.json

4、然后选择这个包源，再进行搜索就有了：

5、安装完成之后，编辑Startup.cs文件。

//首先引入三个命名空间
using System.IO;
using System.Reflection;
using Swashbuckle.AspNetCore.Swagger;


//配置Swagger
//注册Swagger生成器，定义一个Swagger 文档
public void ConfigureServices(IServiceCollection services)
{
    .....

    services.AddSwaggerGen(c =>
    {
        c.SwaggerDoc("v1", new OpenApiInfo
        {
             Version = "v1",
             Title = "接口文档",
             Description = "RESTful API"
        });

        // 为 Swagger 设置xml文档注释路径
        var xmlFile = $"{Assembly.GetExecutingAssembly().GetName().Name}.xml";
        var xmlPath = Path.Combine(AppContext.BaseDirectory, xmlFile);
        c.IncludeXmlComments(xmlPath);
    });

}


public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
   ....

   //启用中间件服务生成Swagger
   app.UseSwagger();
   //启用中间件服务生成Swagger，指定Swagger JSON根节点
   app.UseSwaggerUI(c =>
   {
      c.SwaggerEndpoint("/swagger/v1/swagger.json", "Web App V1");
      c.RoutePrefix = string.Empty;  //设置根节点访问
   });
   
}

详细步骤请移步相关播客：.Net Core WebApi（一）简单创建及使用