快速体验
- 打开 InsCode(快马)平台 https://www.inscode.net
- 输入框内输入如下内容：
创建一个最简单的Spring Boot示例项目，要求：1. 只包含一个'Hello World'API 2. 配置最简Swagger支持 3. 详细注释每个配置步骤 4. 说明如何访问Swagger UI路径（通常是/swagger-ui.html）5. 展示如何阅读API文档- 点击'项目生成'按钮，等待项目生成完整后预览效果
最近在学Spring Boot开发，发现Swagger真是个好东西——它能自动生成API文档，还能直接测试接口。作为新手，第一次配置时踩了不少坑，今天把最简配置流程整理出来，5分钟就能搞定！
- 创建基础Spring Boot项目
建议直接用InsCode(快马)平台的Spring Boot模板，省去初始化配置时间。创建时只需勾选"Web"依赖，生成的项目会自动包含基础的web开发环境。
- 添加Swagger依赖
在项目的pom.xml文件中添加两个关键依赖： - springfox-swagger2：核心功能包 - springfox-swagger-ui：提供可视化界面 添加后记得刷新Maven依赖，平台会自动下载所需库文件。
- 编写示例接口
先创建一个简单的Controller类，添加一个返回"Hello World"的GET接口。用@RestController注解标记类，@GetMapping注解定义路径。这个接口将作为Swagger的演示案例。
- 配置Swagger
新建一个配置类，用@EnableSwagger2注解开启功能。这里需要定义Docket bean来配置扫描范围，通常设置为扫描所有Controller包。还可以设置文档标题、描述等基本信息。
- 启动并访问
运行项目后，默认访问路径是/swagger-ui.html。在InsCode(快马)平台上可以直接点击预览按钮，系统会自动拼接项目地址和Swagger路径，不用手动输入长URL。
- 使用Swagger UI
打开页面后会看到： - 顶部显示API分组和版本信息 - 左侧列出所有检测到的接口 - 点击接口可以展开详细参数和响应说明 - 直接点击"Try it out"就能测试接口
- 常见问题处理
如果访问404，检查： - 依赖是否添加成功 - 配置类路径扫描范围是否正确 - 项目是否配置了上下文路径（需要调整Swagger路径）
在InsCode(快马)平台上实践特别方便，不需要配置本地Java环境，写完代码直接运行就能看到效果。部署后的项目会生成独立访问地址，分享给同事检查API文档也很简单。作为新手，这种开箱即用的体验确实节省了大量搭建环境的时间。
快速体验
- 打开 InsCode(快马)平台 https://www.inscode.net
- 输入框内输入如下内容：
创建一个最简单的Spring Boot示例项目，要求：1. 只包含一个'Hello World'API 2. 配置最简Swagger支持 3. 详细注释每个配置步骤 4. 说明如何访问Swagger UI路径（通常是/swagger-ui.html）5. 展示如何阅读API文档- 点击'项目生成'按钮，等待项目生成完整后预览效果
