**1. 类的文档： `@Tag`** ```java @RestController @Tag(name = "账号接口") public class AccountController { ... } ```  <br/> **2. 方法的文档：`@Operation`** ```java @Operation(summary = "根据账号id查找账号") @GetMapping("/account/getById/{id}") public String getById(@PathVariable("id") Integer id) { return "" + id; } ```  <br/> **3. 参数的文档：`@Parameter`** ```java @Operation(summary = "根据账号id查找账号") @GetMapping("/account/getById/{id}") public String getById(@Parameter(description = "账号id", example = "1000") @PathVariable("id") Integer id) { return "" + id; } ```  <br/> **4. 参数的文档：`@Parameters`** ```java @Parameters( { @Parameter(name = "id", description = "账号id", example = "1000"), @Parameter(name = "username", description = "账号名", example = "zhangsan") } ) @Operation(summary = "根据账号id和账号名查找账号") @GetMapping("/account/getByIdAndUsername") public String getByIdAndUsername(@RequestParam("id") Integer id, @RequestParam("username") String username) { return id + "." + username; } ```  <br/> **5. 实体的文档：`@Schema`** ```java @Schema(description = "账号实体") public class Account { @Schema(description = "账号id", example = "1000") private Integer id; @Schema(description = "账号名", example = "zhangsan") private String username; @Schema(description = "密码", example = "123456") private String password; } ```  >[info]提醒：实体只有被 controller 层引用才能生成文档。 ```java /** * Account 被 controller 层用做参数，或返回值 */ @PostMapping("/account/getAcoount") public Account getAccount(@RequestBody Account account) { return account; } ```