在开发 API 时，Swagger 是一个强大的工具，能够帮助我们自动生成文档并简化接口调试。以下是 Swagger 中几个常用注解的使用方法，让你快速上手！

首先，`@Api` 注解用于描述整个控制器的功能，例如：

```java

@Api(tags = "用户管理模块")

@RestController

@RequestMapping("/user")

public class UserController {

```

接着，`@ApiOperation` 可以为每个接口添加详细说明：

```java

@ApiOperation(value = "获取用户信息", notes = "通过 ID 查询用户详情")

@GetMapping("/{id}")

public User getUser(@PathVariable Long id) { ... }

```

此外，`@ApiParam` 和 `@ApiModelProperty` 用于描述参数和返回值：

```java

@PostMapping

public ResponseEntity createUser(

@ApiParam(value = "用户对象", required = true) @RequestBody User user) { ... }

```

最后，别忘了通过 `@ApiModel` 描述实体类结构：

```java

@ApiModel(description = "用户模型")

public class User { ... }

```

掌握这些注解后，你的 API 文档将变得清晰直观！🚀

💬 如果你有更多问题或需要更详细的示例，欢迎留言讨论！🌟