在日常开发中，Swagger2是构建RESTful API文档的强大工具。它通过注解帮助开发者快速生成接口文档，提升协作效率。以下是一些常用的Swagger2注解，让你的API文档更专业！📚

首先，`@Api`注解用于标记Controller类，为整个模块添加描述信息。例如：`@Api(value = "用户管理模块", description = "提供用户相关操作")`。接着，`@ApiOperation`注解用来描述具体方法的功能，如：`@ApiOperation(value = "获取用户列表", notes = "按条件查询用户数据")`。此外，`@ApiParam`注解用于定义参数信息，比如：`@ApiParam(name = "id", value = "用户ID", required = true)`。最后，别忘了使用`@ApiResponses`和`@ApiResponse`来定义返回值类型及可能的错误码。💡

合理运用这些注解，不仅能让代码更具可读性，还能让团队合作更加顺畅。快试试吧！🚀