视频字幕
在Spring Boot 3.x版本中，传统的Swagger集成方式已经发生了变化。我们需要使用springdoc-openapi库来替代之前的springfox-swagger2，这样可以更好地支持OpenAPI 3规范，提供更现代化的API文档生成功能。
首先需要在项目的pom.xml文件中添加springdoc-openapi的依赖。我们使用springdoc-openapi-starter-webmvc-ui这个启动器，建议版本选择2.0.0或更高版本。这个依赖会自动配置Swagger UI界面，无需额外的配置类。
接下来需要在application.yml配置文件中进行相关设置。我们可以配置API文档的访问路径，默认是/v3/api-docs，还可以设置Swagger UI的访问路径为/swagger-ui.html，并确保启用状态为true。配置完成后，启动应用就可以通过浏览器访问Swagger界面了。
Swagger是一个强大的开源API文档生成工具，专门用于RESTful API的文档化。它可以自动根据代码中的注解生成交互式的API文档，让开发者可以直观地查看和测试API接口。Spring Boot与Swagger的集成非常简单，只需要添加相应的依赖和配置即可。
首先需要在项目的pom.xml文件中添加Swagger依赖。推荐使用springdoc-openapi-starter-webmvc-ui，这是目前最新的Spring Boot集成Swagger的方案。添加这个依赖后，Spring Boot会自动配置Swagger UI，无需额外的配置类。
接下来需要在application.yml文件中进行Swagger配置。可以自定义API文档的访问路径和Swagger UI的访问路径。还可以指定要扫描的包路径，确保只扫描Controller类所在的包，提高文档生成的效率。
在Controller类中，我们需要使用相应的Swagger注解来描述API接口。@Tag注解用于标记控制器的分组名称，@Operation注解用于描述具体的接口操作，@Parameter可以描述请求参数，@ApiResponse用于描述响应信息。这些注解会自动生成详细的API文档。
完成配置后，启动Spring Boot应用，就可以通过浏览器访问Swagger UI界面了。默认访问地址是localhost:8080/swagger-ui.html。在这个界面中，可以查看所有的API接口，每个接口都有详细的参数说明和响应示例，还可以直接在线测试接口功能。
完成所有配置后，启动Spring Boot应用，就可以通过浏览器访问Swagger UI界面了。在这个界面中，可以看到所有的API接口按控制器分组显示，每个接口都有详细的参数说明。最重要的是，可以直接点击Try it out按钮在线测试接口，非常方便开发和调试。