swagger生成api接口文档怎么配置

Swagger是一个流行的API开发工具，用于自动生成RESTful API接口的详细文档。以下是基本的配置步骤：

1. **安装Swagger**：首先需要在项目中引入Swagger的核心库，如果你使用的是Spring Boot，可以添加Swagger的依赖到`pom.xml`文件或`build.gradle`文件。

   <!-- Maven -->
   <dependency>
       <groupId>io.springfox</groupId>
       <artifactId>springfox-swagger2</artifactId>
       <version>3.x.y</version>
   </dependency>

   <!-- Gradle -->
   implementation 'io.springfox:springfox-boot-starter:3.x.y'

2. **创建配置类**：在Spring Boot应用中，创建一个配置类并启用Swagger。例如，在Java配置中：

   @Configuration
   public class SwaggerConfig {

       @Bean
       public Docket createRestApi() {
           return new Docket(DocumentationType.SWAGGER_2)
               .select()
               .apis(RequestHandlerSelectors.basePackage("your.package.name")) // 指定扫描的包名
               .paths(PathSelectors.any()) // 全部路径
               .build()
               .apiInfo(apiInfo()); // 设置标题、描述等信息
       }

       private ApiInfo apiInfo() {
           return new ApiInfoBuilder()
               .title("Your API Title")
               .description("A brief description of your API")
               .contact(new Contact("Your Name", "Your Website", "youremail@example.com"))
               .version("1.0.0")
               .build();
       }
   }

3. **启用Swagger UI**：在Web应用中，你需要集成Swagger UI以便于查看和测试API。通常，这涉及到配置一个静态资源处理器来提供Swagger的HTML文件。

4. **访问API文档**：部署应用后，通过访问`http://localhost:8080/swagger-ui.html`（默认端口），即可看到自动生成的API文档页面。