Swagger 文档太丑?Knife4j 给接口文档换层皮,前后端沟通效率翻倍

🎨 增强 UI

重新设计文档界面，比原生 Swagger 好看 10 倍。深色主题、响应式布局、文档分组、接口搜索，全部支持。

✅ 参数校验

配合 @Validated 注解，自动校验请求参数。前端在文档页面填写参数，点击发送，自动展示校验结果，无需 Postman。

📥 离线导出

支持导出 OpenAPI 规范的 JSON/YAML，也支持导出 PDF、Markdown 文档。离线后发给前端，不用给服务器地址。

🔒 安全增强

支持设置访问密码、配置全局 Authorization、IP 白名单、接口脱敏。文档安全性更高，防止接口泄露。

<dependency>     <groupId>com.github.xiaoymin</groupId>     <artifactId>knife4j-openapi3-spring-boot-starter</artifactId>     <version>4.5.0</version> </dependency>

knife4j:   enable: true   documents:     - name: user       locations: classpath:doc/user.md   setting:     language: zh_cn

@Tag(name = "用户接口", description = "用户相关接口") @RestController @RequestMapping("/api/user") public class UserController {      @Operation(summary = "分页查询用户")     @PostMapping("/list")     public R<PageResult<UserVO>> list(             @RequestBody @Valid @RequestBody UserQuery query) {         return R.ok(userService.queryPage(query));     }      @Operation(summary = "新增用户")     @PostMapping     public R<Void> add(@Valid @RequestBody UserDTO dto) {         userService.add(dto);         return R.ok();     } }

🔗 前后端分离 — 前端实时查看接口定义，减少沟通成本

📄 接口文档 — 自动生成文档，无需手动维护

✅ 接口测试 — 在文档页面直接测试接口

📥 离线文档 — 导出 PDF 给外部合作方

🔒 接口安全 — 设置密码、脱敏，保护接口文档