Go swaggo 通过 tag 限制生成接口文档的范围

4 min read

要通过 tag 限制生成接口文档的范围,在 Swagger 注解中添加 @Tags 标签并在括号中指定要包含的标签即可。

例如,如果您有两组 API,一组标有 "users" 和 "authentication" 标签,另一组标有 "products" 和 "inventory" 标签,您可以使用以下代码限制只生成用户和身份验证相关的 API 的文档:

@Tags({"users", "authentication"})

如果要生成与产品和库存相关的API的文档,请使用以下代码:

@Tags({"products", "inventory"})

您甚至可以使用逗号分隔值指定多个标签,如下所示:

@Tags({"users", "authentication", "products"})

此外,您还可以在 Swagger UI 中使用左侧的标签选择器来过滤要显示的 API。