Fitten Code插件可零代码入侵生成交互式API文档:登录插件后选中完整Controller类→右键生成Markdown文档→导出openapi.json→放入resources/static→通过Swagger UI访问调试。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

你需要在已有Java Spring Boot项目中,不改动业务逻辑的前提下,为Controller接口快速生成可访问的交互式API文档页面,避免手写Swagger注解带来的代码侵入和维护负担。
确认Fitten Code已安装并登录
打开VS Code → 点击左侧活动栏Extensions图标 → 在搜索框输入“Fitten Code” → 找到官方插件并点击Install → 安装完成后重启编辑器 → 启动后右下角出现Fitten Code图标,点击登录账号(支持邮箱或手机号)。
若右下角无图标或登录失败,【必须重新安装插件并检查网络代理设置】——未登录状态下所有AI功能(包括文档生成)均被禁用,且不会提示明确错误。
选中Controller类,触发智能文档生成
在项目中打开任意一个含@RestController或@Controller注解的Java文件 → 用鼠标拖选整个类定义(从public class XXX开始,到对应的大括号结束)→ 右键 → 选择“Fitten Code – Generate API Documentation”。
这一步不能只选方法体或部分字段——Fitten Code依赖类级上下文推断API分组、路径前缀与共享响应结构;选中范围过小会导致生成的文档缺失@Tag分组、basePath和全局异常说明。
查看并确认生成结果
生成过程约2~5秒,完成后弹出预览窗口,显示结构化Markdown格式文档,含:接口列表、每个接口的HTTP方法+路径、参数表格(含类型、是否必填、描述)、响应示例(JSON格式)、状态码说明。
若发现某接口参数未标注(如@RequestParam未识别为查询参数),立即返回源码,将该参数行上方添加一行JavaDoc注释,例如“/** 用户手机号,11位数字 */”,再重新执行生成操作——Fitten Code优先信任显式注释而非仅靠反射推断。
导出为OpenAPI 3.0 JSON并接入Swagger UI
在预览窗口右上角点击“Export as OpenAPI v3 JSON” → 保存为openapi.json → 将该文件放入项目resources/static目录下 → 启动Spring Boot应用 → 访问http://localhost:8080/swagger-ui/index.html → 点击右上角“Explore” → 选择“Select File” → 上传刚保存的openapi.json。
此时页面即呈现标准Swagger UI界面,所有接口可直接调试。注意:此方式绕过springdoc注解,【无需修改pom.xml或添加任何@Tag/@Operation】,完全零代码入侵。


















